Backup SSH auth

Prefer a full private key for scheduled backups. Password auth needs sshpass on the app server.

Settingbackup_ssh_private_key

Backup SSH auth

How the app authenticates to the backup SSH host.

Where to find it

Admin → Backup

Field Key Notes
SSH private key backup_ssh_private_key Full PEM/OpenSSH key including BEGIN/END lines
SSH password backup_ssh_password Optional; used only if sshpass is installed

Prefer a key. Password + sshpass is allowed but fragile. An env identity file (BACKUP_SSH_IDENTITY_FILE) can override a pasted key.

Leave secret fields blank on later saves to keep the stored value.

Common problems

Scheduled backups fail auth, password "works" interactively

Install key auth into authorized_keys. Ensure sshpass exists if you rely on password only.

Key rejected

Wrong key pair, passphrase-protected key pasted as-is, or remote authorized_keys missing the matching public key.

Related