Skip to content

SSH Keys

SSH keys are how you push code to Plitho. Your key proves your identity — no passwords needed for git push.

Two Types of Keys

Key What it's for Where to manage
Account key Your personal SSH key for git push and SSH commands My Account in the dashboard
App key Per-app key for fine-grained access (e.g., CI/CD) Apps → your app → SSH tab

Your account key is what you use day-to-day. App keys are optional — for granting specific apps access to specific keys.

Adding Your SSH Key

  1. Go to My Account in the dashboard
  2. Paste your SSH public key
  3. Click ADD KEY

Account page

Getting Your Public Key

# Ed25519 (recommended)
cat ~/.ssh/id_ed25519.pub

# RSA (legacy)
cat ~/.ssh/id_rsa.pub

Copy the entire line.

Don't Have a Key?

Generate one:

ssh-keygen -t ed25519 -C "your-email@example.com"

Then copy the public key as shown above.

How Key Authentication Works

When you git push or use SSH commands:

  1. The SSH server looks up your public key
  2. It finds which user owns that key
  3. It checks if you have access to the requested app
  4. Admin users can access all apps
  5. Regular users can only access apps they own

If you try to push to an app you don't own:

Permission denied: you don't own this app

Adding the Git Remote

git remote add plitho ssh://plitho@your-server:2222/myapp

Note

The SSH username is always plitho. Your identity is determined by your SSH key, not the username in the URL.

Removing a Key

Click Remove next to the key in My Account.

Warning

Make sure you have another key added before removing your only key, or you'll be locked out of SSH access.

Per-App Keys

For fine-grained access (e.g., giving a CI/CD system access to one app):

  1. Go to Apps → your app → SSH tab
  2. Add the key

This key can only push to that specific app, not your other apps.

SSH Commands

You can also manage apps via SSH:

ssh -p 2222 plitho@your-server ls              # list your apps
ssh -p 2222 plitho@your-server start myapp     # deploy/start
ssh -p 2222 plitho@your-server stop myapp      # stop
ssh -p 2222 plitho@your-server log myapp       # view logs

See SSH Commands Reference for the full list.