Common Errors

You might face of any these issues while using Caido.

Error Message: "You do not have access to this instance".

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

Resolution Method 1:

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

Resolution Method 2:

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.

Resolution Method 3:

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.

Error Message: "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.

Resolution:

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.

Error Message: "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.

INFO

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.

Resolution for Windows

INFO

Time synchronization instructions for Windows can be found here.

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

Resolution for MacOS

INFO

Time synchronization instructions for MacOS can be found here.

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.

Resolution for Linux

INFO

Time synchronization instructions for Linux can be found here.

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.

Error: Unexpected error when rendering on the frontend.

If you 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"))

Resolution Method 1:

Do not run Caido as the root user.

Resolution Method 2:

Remove the following flag when launching Caido:

• --no-renderer-sandbox

Error: Could not initialize configuration.

If you encounter this error and receive a 404 status code on https://api.caido.io/oauth2/register along with 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)

Resolution:

Check your internet connection.

INFO

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).

View the Authentication documentation for more information.

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.

Resolution:

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

I cannot call my data in the GraphQL Playground.

You must add your Authorization header.

Resolution:

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"
}

TIP

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 window pane is not available anymore.

The pane may have accidentally been minimized in size.

Resolution:

Resize the pane.