Troubleshooting

Something not working in Caret? Start here. This page walks through the problems people run into most often and how to fix them. If none of it helps, email us — we read every message.

Can't connect to a server

A failed connection is almost always one of these:

  • Wrong host, port or username. Double-check the address, the port (usually 22), and the login name. If you can, try the same details from another SSH app on the same network to confirm they work.
  • The server isn't reachable. Make sure your device has internet access, and if the server is on a home or office network, that you're on that network or connected through its VPN. A server on a private network can't be reached from outside unless it has been set up for that.
  • A firewall is blocking SSH. The server's firewall — and, on a cloud server, the provider's security group — must allow SSH on the port you're using.
  • The login was rejected. For password login, re-enter the password. For key login, make sure you imported the matching private key and typed the correct passphrase.
  • "The server's identity changed." Caret warns you when a server's fingerprint no longer matches what it saw before. This can be normal after a server is rebuilt — but if you weren't expecting it, stop and check, because it can also mean the connection isn't safe. Only accept the new identity if you know why it changed.

The connection keeps dropping

  • Check your device's network — switching between Wi-Fi and mobile data, or a weak signal, can interrupt the session.
  • Some servers and routers close idle connections after a while. Reopening the connection brings it back.
  • On the server side, heavy load or a restart will also drop existing sessions.

The Docker tab says it's unavailable

If Caret connects but the Docker screen shows "not available", "no permission", or an error:

  • Docker isn't installed or isn't running on that server. Caret can only manage Docker on servers that already have it.
  • Your account doesn't have permission to use Docker. On many systems, only an administrator — or a user added to the docker group — can talk to Docker. Connect with an account that has that access.
  • On some NAS systems (for example Synology), Docker is set up so that only an administrator account can manage it. Sign in with an admin user and try again.

Tap Retry once you've fixed the cause.

The terminal looks wrong

  • Garbled characters or odd colors usually mean a mismatch with the server's terminal settings. Most servers work out of the box; if yours doesn't, this is typically a server-side setting.
  • The on-screen keys (arrows, Ctrl, Tab, Esc) are on the toolbar above the keyboard — use them for shortcuts and command-line editing.

The monitoring charts are empty

  • The live CPU, memory and other readings come straight from the server while you're connected. If a chart stays empty, the connection may have dropped — reconnect and check.
  • Some detailed statistics need a small helper installed on the server. Caret offers to set this up when it's missing; follow the prompt if you want those extra charts.

Cloud sync isn't working

Sync is optional and uses your own iCloud or Google Drive — Caret has no servers of its own.

  • iCloud: make sure your device is signed in to iCloud and that iCloud Drive is turned on. Sync only works between devices using the same Apple ID.
  • Google Drive: you'll be asked to sign in and set a master password. That password protects your data with end-to-end encryption — it's never uploaded and cannot be recovered if you lose it. If sync won't unlock on a new device, the most likely cause is a mistyped master password.
  • Give a new device a moment after you enable sync — the first download can take a little time.

A purchase didn't unlock, or I switched devices

  • Open the upgrade screen and tap Restore purchases to bring back a lifetime purchase or an active subscription on a new or reset device.
  • Restored purchases are tied to the App Store or Google Play account that made them — use the same account.
  • For refunds or billing questions, contact the App Store or Google Play directly. They handle the payment; Caret never sees your payment details.

Still need help?

If none of the above fixed it, send us a note with:

  • your device and its operating system version,
  • the app version (Settings → About),
  • and what you were doing when the problem happened — plus the exact wording of any error message.

The more detail you give, the faster we can help.