Troubleshooting
Here you'll find solutions to common issues you might face while using Caido.
Installation Issues
"The SUID sandbox helper binary was found, but is not configured correctly."
If you're using Linux and have installed Caido using the AppImage installation method, you may encounter an error, accompanied by a message similar to the following:
[142547:0410/141348.635410:FATAL:setuid_sandbox_host.cc(163)] The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now. You need to make sure that /tmp/.mount_caido-PMiQot/chrome-sandbox is owned by root and has mode 4755.
This error happens due to AppArmor, the Linux application security system. Each time Caido is launched, it loads itself in the tmp
folder as a virtual file system before execution. This means there is no hook to add an AppArmor profile, which defines exactly what a certain program is allowed and not allowed to do in the context of the operating system.
There are three ways to work around this issue (listed in order, beginning with the most secure to the least secure methods):
INFO
For the following commands throughout each of the three methods, be sure to replace /path/to/caido-desktop-vX.XX.X-linux-<architecture>.AppImage
with the path, versioning, and architecture to the AppImage file that is appropriate to you. If you renamed the file, account for that as well.
Create an AppArmor Profile for Caido (Preferred Method):
- Create a new profile file in the AppArmor profile directory with:
sudo nano /etc/apparmor.d/appimage.caido
- The file's content should be:
abi <abi/4.0>,
include <tunables/global>
profile appimage.caido /path/to/caido-desktop-vX.XX.X-linux-<architecture>.AppImage flags=(unconfined) {
userns,
include if exists <local/appimage.caido>
}
- Read and load the profile with:
apparmor_parser -r /etc/apparmor.d/appimage.caido
Run Caido without a Sandbox
To disable the AppArmor sandbox security restrictions, use the --no-sandbox
argument when launching Caido:
/path/to/caido-desktop-vX.XX.X-linux-<architecture>.AppImage --no-sandbox
If you would like to apply this to every launch:
- Create a file with the
.desktop
extension located in either:
~/.local/share/applications/
for the current user account./usr/share/applications/
for all user accounts.
- The file's content should be:
[Desktop Entry]
Version=1.0
Name=Caido
Comment=Caido - A platform for secure vulnerability management
Exec=/path/to/caido-desktop-vX.XX.X-linux-<architecture>.AppImage --no-sandbox
Icon=/path/to/caido-icon.png
Terminal=false
Type=Application
Categories=Security;Utility;Networking;
StartupNotify=true
- Refresh the desktop application icon cache with:
sudo update-icon-caches /usr/share/icons/*
TIPS
Ensure to replace
/path/to/caido-icon.png
with the actual path and filename of the image you want to use for Caido's desktop application icon.You can use the Caido logo as the image by downloading it from https://github.com/caido/caido/blob/main/brand/png/logo.png.
Disable AppArmor (Not Recommended)
To disable AppArmor globally, run the following command:
sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
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:
- Right-click on the clock.
- Select
Adjust date and time
. - Go to
Date & Time
inSettings
. - Click
Sync now
.
Fixing on macOS:
- Open a terminal window.
- Use the
sntp
command with the-S
option to slew the clock:
sudo sntp -S pool.ntp.org
- Check the time synchronization status again using the same command.
Fixing on Linux:
- Open a terminal or SSH into your server.
- Install the NTP package:
sudo apt-get install ntp
- Once the installation is complete, the NTP service should start automatically.
- Check its status with:
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 theCAIDO_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.