Troubleshooting

Here you'll find solutions to common issues you might face while using Caido.

Startup Issues

"Could not initialize configuration."

If you encounter a similar message to the following:

Error: Could not initialize configuration
Caused by:
    0: Authentication service error
    1: Cloud operation failed
    2: Cloud unavailable
    3: error sending request for url (https://api.caido.io/oauth2/register): error trying to connect: tcp connect error: Connection refused (os error 111)
    4: error trying to connect: tcp connect error: Connection refused (os error 111)
    5: tcp connect error: Connection refused (os error 111)
    6: Connection refused (os error 111)

Check your internet connection. Caido requires an internet connection at the following moments:

• On first launch.
• During login.
• After 7 days offline (the time period after which your authentication token needs to be refreshed).

For more information on why/when this is required, view the Authentication page.

Login Issues

Can't Access Instance

You may encounter this error when trying to access an Instance that you do not own. This can occur if you've initially setup a Caido Instance using a different account.

To resolve this issue, you can either:

• Login to the initial account that was used to setup your Caido Instance.

• Reset the Instance credentials:

  • If using the CLI, start Caido using caido --reset-credentials.
  • If using the desktop application, check the Reset Credentials checkbox in your Instance's advanced settings.

  WARNING

  These settings will allow you to login with any account you want. Once you've claimed your Instance, make sure to remove the --reset-credentials option or checkbox, otherwise your Instance credentials will be reset on every launch.

  

• Delete your data folder.

  • While not ideal, deleting your Caido data folder will allow you to start with a fresh installation. View the Files page to locate your data folder.

"Login URL generation failed: invalid authentication token".

You may encounter this error when trying to access an Instance that you deleted in the Caido Dashboard.

To resolve this, reset the Instance credentials:

• If using the CLI, start Caido using caido --reset-credentials.

• If using the desktop application, check the Reset Credentials checkbox in your Instance's advanced settings.

WARNING

These settings will allow you to login with any account you want. Once you've claimed your Instance, make sure to remove the --reset-credentials option or checkbox, otherwise your Instance credentials will be reset on every launch.

"Date mismatch: make sure your device's date and time settings are correct".

If you encounter this error during login, it means that your computer time is likely out of sync. Visit time.is to confirm it.

Caido allows 5 minutes of deviation between the "real" time and your computer time. To fix it, you will have to manually resync the time using NTP.

• Fixing on Windows:

  1. Right-click on the clock.
  2. Select Adjust date and time.
  3. Go to Date & Time in Settings.
  4. Click Sync now.

• Fixing on macOS

  1. Open a terminal window.
  2. Use the sntp command with the -S option to slew the clock (sudo sntp -S pool.ntp.org).
  3. Check the time synchronization status again using the same command.

• Fixing on Linux

  1. Open a terminal or SSH into your server.
  2. Install the NTP package: sudo apt-get install ntp.
  3. Once the installation is complete, the NTP service should start automatically.
  4. Check its status by using this command sudo systemctl status ntp.

In-App Issues

Can't Preview Responses

If you're unable to preview responses, you may encounter a rendering error, accompanied by a log error message entry similar to the following:

Rendering error: LaunchIo(Custom { kind: UnexpectedEof, error: "unexpected end of stream" }, BrowserStderr("[0101/110718.156035:ERROR:zygote_host_impl_linux.cc(90)] Running as root without --no-sandbox is not supported. See https://crbug.com/638180.\n"))

This error happens when Caido is running as root.

To fix it, you can either:

• Not run Caido as the root user.
• Remove the following flag when launching Caido:
  • --no-renderer-sandbox

I have paid for "Pro" but it still shows "Community" in the application.

Caido caches the state of your account. Any changes to your account can take some time to update.

Refresh your account state by logging out/logging into your Caido Instance.

The GraphQL Playground Doesn't Work

This might happen because you haven't added your Authorization header.

In GraphQL Playground, you can add an Authorization header as follows:

• Open GraphQL Playground in your browser.
• Locate the "HTTP HEADERS" pane on the bottom left side of the interface.
• Enter your Authorization header in the following format:

{
  "Authorization": "Bearer ACCESS_TOKEN_HERE"
}

To acquire your token:

• Right-click inside the Caido application.
• Select Inspect.
• Select the Application tab.
• Under Storage - Local storage within the left-hand side menu, select the listening address/port of Caido.
• Copy the value of the accessToken (within the value of the CAIDO_AUTHENTICATION key).

A Section of the UI is Missing

Caido allows you to resize parts of the UI. You might have accidentally minimized one of the sections.