SSH Commands¶
Manage your apps via SSH without using the dashboard.
Basic Usage¶
ssh -p 2222 plitho@your-server <command> [args]
Note
The SSH username is always plitho. Your identity is determined by your SSH key.
Commands¶
ls — List Apps¶
ssh -p 2222 plitho@your-server ls
----------------------------------------
Plitho v0.1.0
+ myapp [ status: running ]
+ mysite [ status: running ]
Use ls -x for expanded output with runtime, port, and revision:
ssh -p 2222 plitho@your-server ls -x
+ myapp [ status: running | runtime: node | rev: abc1234 ]
+ mysite [ status: running | runtime: static | rev: def5678 ]
start — Deploy/Start¶
ssh -p 2222 plitho@your-server start myapp
Triggers a full deployment: pulls code, installs dependencies, runs scripts, starts the process.
stop — Stop¶
ssh -p 2222 plitho@your-server stop myapp
Stops the app. It remains in the system and can be started again.
reload — Restart¶
ssh -p 2222 plitho@your-server reload myapp
Restarts the process without a full redeploy. Use after environment variable changes.
reload-all — Restart All Apps¶
ssh -p 2222 plitho@your-server reload-all
Restarts all your apps. Admin only.
stop-all — Stop All Apps¶
ssh -p 2222 plitho@your-server stop-all
Stops all your apps. Admin only.
rm — Delete¶
# Interactive (prompts for confirmation)
ssh -p 2222 plitho@your-server rm myapp
# Force (no confirmation)
ssh -p 2222 plitho@your-server rm -f myapp
Danger
Permanently deletes the app, its git repository, and all data.
log — View Logs¶
ssh -p 2222 plitho@your-server log myapp
Streams real-time logs. Press Ctrl+C to stop.
To view logs for a specific process:
ssh -p 2222 plitho@your-server log myapp web
scale — Scale Workers¶
ssh -p 2222 plitho@your-server scale myapp web=4
Scale multiple processes at once:
ssh -p 2222 plitho@your-server scale myapp web=4 worker=2
reset-ssl — Reissue SSL¶
ssh -p 2222 plitho@your-server reset-ssl myapp
info — App Details¶
ssh -p 2222 plitho@your-server info myapp
----------------------------------------
Name: myapp
Runtime: node
Status: running
Server Name: myapp.example.com
Port: 3000
Revision: abc1234
shell — Interactive Shell¶
ssh -p 2222 plitho@your-server shell myapp
Opens a jailed shell session inside your app's environment. Requires SSH shell access to be enabled in the dashboard.
system:version — Show Version¶
ssh -p 2222 plitho@your-server system:version
tar-deploy — Tar Deploy¶
ssh -p 2222 plitho@your-server tar-deploy myapp --stream
Receives a tar stream and deploys it. Used by the CLI and tar deploy workflows.
Access Control¶
| User Type | Can Manage |
|---|---|
| Regular user | Only their own apps |
| Admin user | All apps from all users |
Quick Reference¶
| Command | Description |
|---|---|
ls |
List your apps |
ls -x |
Expanded list with details |
start <app> |
Deploy/start an app |
stop <app> |
Stop an app |
reload <app> |
Restart an app |
reload-all |
Restart all apps (admin) |
stop-all |
Stop all apps (admin) |
rm <app> |
Delete an app (interactive) |
rm -f <app> |
Delete an app (force) |
log <app> |
Stream logs |
log <app> <proc> |
Stream logs for specific process |
scale <app> web=N |
Scale workers |
info <app> |
App details |
shell <app> |
Interactive shell (if enabled) |
reset-ssl <app> |
Reissue SSL |
system:version |
Show version |