Skip to content

GitHub Actions Secrets

Each repo that deploys to this VPS needs the following secrets set under Settings → Secrets and variables → Actions.

Required secrets

Secret Value
VPS_HOST Your VPS IP address or hostname
VPS_USER SSH user (e.g. ubuntu)
VPS_SSH_KEY Private SSH key (the full contents of ~/.ssh/id_ed25519)

Adding your SSH key

Generate a dedicated deploy key on the VPS if you don't have one:

ssh-keygen -t ed25519 -C "github-actions-deploy" -f ~/.ssh/deploy_key
cat ~/.ssh/deploy_key.pub >> ~/.ssh/authorized_keys

Then paste the contents of ~/.ssh/deploy_key (private key) into the VPS_SSH_KEY secret in GitHub.

Per-app secrets

Some apps have additional secrets needed in their .env file on the VPS. These are documented on each app's page.