Support
A question, a bug or an idea? Write to support@cardolabs.com.
Most answers are in the Rajada user guide.
To help us help you, mention your macOS version, the app version (menu Rajada → About), and what you expected to happen.
Frequently asked questions: Getting started · Connections · Runs · Rajada Pro · Privacy and security · Your data
Getting started
Which Macs can run Rajada?
Any Mac with macOS 26.2 or later.
Why does the app ask me to select my SSH key?
The app is sandboxed: it cannot read ~/.ssh on its own. It only gets access to the key files you pick with Add Key…. Removing a key from the list never deletes the file.
Does Rajada read my ~/.ssh/config?
Not by itself. Use File › Import Hosts from ssh config… (Rajada Pro) to add its hosts once: host names, users, ports and jump hosts are taken over. Add your keys before importing, so each host is linked to its key. If the file uses Include, Rajada asks for access to the folder of the included files.
Can I log in with a password instead of a key?
Yes. When a server asks for a password, Rajada shows the prompt. Tick Remember in Keychain to save it in the macOS Keychain. Keys protected by a passphrase work the same way.
Can I use keys held by an SSH agent or a password manager?
Rajada uses the private key files you add. A key that exists only inside an agent, with no file on disk, cannot be used.
How do I reach a server behind a bastion?
Fill in the host's Jump host field with user@bastion or user@bastion:port. Up to four jump hosts, separated by commas, are crossed in order.
Connections
I get “Permission denied (publickey)”.
The server refused the key. Check, in the host's settings, which SSH key it uses (the default key if none is set), that the matching public key is in ~/.ssh/authorized_keys of that user on the server, and that the user name is right.
The connection times out.
Rajada gives up after 10 seconds without an answer. Check that the host name and port are right, that the server is reachable from this Mac (VPN, firewall), and that its SSH server is running. A jump host can help for servers on a private network.
Rajada asks me to trust a server my Terminal already knows.
Rajada keeps its own list of trusted host keys and does not read ~/.ssh/known_hosts. Compare the fingerprint it shows with the server's, then trust it once. File › Trusted Host Keys… lists them all.
A host shows “key changed” and the connection is blocked.
The server presents a different key from the one you trusted. It happens after a reinstall, and it is also what an interception attempt looks like. Check the new fingerprint on the server itself before forgetting the old key in File › Trusted Host Keys….
What happens when a terminal session drops?
Rajada reconnects by itself, up to five times, waiting a little longer each time. You can turn this off in Settings › Terminal. Quitting Rajada ends every session.
Runs
Where do my commands run?
In the login shell of the user you connect as, as if you had typed them after logging in. A group's shared commands run first, then the host's own.
Can I use sudo in a batch run?
Batch runs have no terminal, so a sudo that asks for a password cannot be answered and fails. Allow the commands you need without a password in the server's sudoers file, or run them in the host's Terminal tab, where sudo works as usual.
Why does Rajada ask for confirmation before some runs?
It asks when a run involves many hosts (5 or more by default) or a command that looks destructive, such as rm -rf, reboot or mkfs. Both are set in Settings › Safety, and the app lock can require Touch ID as well. It is a safety net against slips, not a guarantee.
Some hosts failed. Do I have to run everything again?
No. Rerun Failed runs the last job again on the hosts that failed, were cancelled or were never reached, and on them only.
Can I keep passwords in my commands?
Please don't: commands are stored unencrypted. If a command needs a password, let the server ask for it.
Rajada Pro
What does Rajada Pro add?
Unlimited hosts (the free version manages up to 5), progressive rollout, file uploads and downloads, tunnels, host status, output comparison and import. Terminals, batch runs and every safety feature are free.
Is it a subscription?
No. Rajada Pro is a one-time purchase: CHF 10 in Switzerland, the equivalent elsewhere.
I bought Pro. How do I get it on another Mac?
Sign in with the same Apple Account, open Settings › Rajada Pro › Get Pro… and choose Restore Purchase.
How do I get a refund?
Purchases go through Apple: request a refund at reportaproblem.apple.com.
Privacy and security
Does Rajada send anything to CardoLabs?
No. There is no account, no analytics and no server of ours. The app connects to your servers, to the App Store for the purchase, and to GitHub only when you download a terminal theme or a Nerd Font. See the privacy policy.
How are my passwords protected?
Only the passwords you choose to remember are saved, in the macOS Keychain. Settings › Saved Passwords › Forget All… erases them.
Is the run history safe?
It is encrypted on your Mac, and passwords and tokens that appear in output can be masked before saving. Both are options in Settings › Run History, where the history can also be turned off.
Can I lock the app?
Yes. Settings › App Lock requires Touch ID or your password to open Rajada and locks it after inactivity or when the Mac sleeps. ⌃⌘L locks it at once.
Your data
Where is my data stored?
On your Mac only, in the app's sandbox container (~/Library/Containers/com.cardolabs.rajada) and, for saved passwords, in the Keychain.
How do I move to a new Mac?
On the old Mac, File › Export Configuration… saves your hosts, groups, tags, tunnels and snippets (no passwords and no keys). On the new one, add your SSH keys first, then File › Import Configuration… (Rajada Pro).
How do I uninstall Rajada completely?
Move the app to the Trash. To remove its data too, delete ~/Library/Containers/com.cardolabs.rajada, and in Keychain Access delete the items whose name starts with com.cardolabs.rajada.
Your question isn't here? Write to support@cardolabs.com.