Setting Up SSH Access
SSH (Secure Shell) provides secure remote access to your Cassette. This guide will walk you through creating SSH keys and configuring access.
Creating an SSH Key Pair
On macOS/Linux
Open your terminal and run:
ssh-keygen -t ed25519 -C "your-email@example.com"
When prompted:
- Press Enter to accept the default file location
- Enter a passphrase (recommended) or press Enter for no passphrase
On Windows
Using PowerShell:
ssh-keygen -t ed25519 -C "your-email@example.com"
Or use PuTTYgen for a GUI approach.
Adding Your SSH Key to Cassette
Method 1: Through the Dashboard
- Go to Settings → SSH Keys
- Click
Add SSH Key
- Give your key a name (e.g.,
My Laptop
) - Paste your public key content
- Click
Save
To get your public key:
cat ~/.ssh/id_ed25519.pub
Method 2: During Instance Creation
When creating a new Cassette, you can select which SSH keys to add during the provisioning process.
Connecting to Your Cassette
Once your key is added:
ssh root@your-cassette-ip
Custom SSH Configuration
Create or edit ~/.ssh/config:
Host my-cassette
HostName your-cassette-ip
User root
IdentityFile ~/.ssh/id_ed25519
Now connect with:
ssh my-cassette
Managing Multiple Keys
You can add multiple SSH keys to a single Cassette:
- Navigate to your Cassette's page
- Click
SSH Keys
tab - Select keys to add or remove
- Changes take effect immediately
Security Best Practices
- Always use a passphrase on your private key
- Never share your private key - only share the public key
- Rotate keys regularly - we recommend every 6 months
- Use different keys for different purposes (personal, work, etc.)
Troubleshooting
Permission Denied
If you get Permission denied (publickey)
, check:
- Your key is added to the Cassette
- You're using the correct username (usually root)
- Your private key has correct permissions: chmod 600 ~/.ssh/id_ed25519
Connection Timeout
- Verify your Cassette is running
- Check firewall rules allow SSH (port 22)
- Ensure you're using the correct IP address