1. Generate a key (if you don’t have one)
macOS / Linux
Windows (PowerShell)
~/.ssh/id_ed25519— your private key. Never share. Never paste anywhere.~/.ssh/id_ed25519.pub— your public key. Safe to share.
2. Add the public key
macOS
Linux (with xclip)
Windows PowerShell
macbook-2026), save.
3. Connect to an instance
After launching a pod, the modal shows something like:yes at the fingerprint prompt the first time.
4. Save the connection in your SSH config
If you’ll reconnect often:~/.ssh/config
ssh gpu-rtx4090. StrictHostKeyChecking no + the /dev/null
known_hosts trick is reasonable here because every rental gets a fresh IP
and you’d otherwise build up a giant known_hosts that you’d have to clear.
Troubleshooting
Permission denied (publickey)
Permission denied (publickey)
Your local key isn’t matching any of the keys you’ve added. Verify:Should match the key you pasted in the dashboard. If it doesn’t, you may
have multiple keys — pass
-i explicitly:Connection timed out
Connection timed out
Three causes:
- Pod still provisioning — wait until status says running in the dashboard
- Wrong port — every pod gets a random high port. Check the modal.
- Your firewall — corporate VPNs sometimes block outbound on non-standard ports. Test from a different network.
Connection refused
Connection refused
Pod’s SSH daemon isn’t up yet — happens during the last 5 seconds of
provisioning. Wait, retry.
My key worked yesterday, doesn't today
My key worked yesterday, doesn't today
You probably deleted the key from the dashboard and launched a new pod.
New pods only see the keys present at the moment of launch. Re-add the
key, launch a fresh pod.
Multiple keys, want to use a specific one
Multiple keys, want to use a specific one
Either use
-i ~/.ssh/specific_key per-command or pin it in
~/.ssh/config per-host (see above).Copying files
Local → pod (entire folder)
Pod → local (single file)
Pod → S3 (from inside the pod)
Port forwarding (Jupyter, vLLM web UI, etc.)
If you’re running Jupyter on port 8888 inside the pod and want it onlocalhost:8888 locally: