Create an SSH key and add it to your server

An SSH key pair consists of a private key (stays secret, goes into the platform) and a public key (goes onto the server).

1. Generate the key pair

Open a terminal (macOS/Linux: Terminal, Windows: PowerShell) and run:

ssh-keygen -t ed25519 -C "application-platform" -f ~/.ssh/application-platform

Confirm the prompts with Enter. Two files are created:

• ~/.ssh/application-platform – the private key
• ~/.ssh/application-platform.pub – the public key

2. Add the public key to the server

Easiest with ssh-copy-id (replace user and host):

ssh-copy-id -i ~/.ssh/application-platform.pub deploy@your-server.example.com

Or manually: append the contents of the .pub file to the ~/.ssh/authorized_keys file of the desired user on the server.

Test the connection:

ssh -i ~/.ssh/application-platform deploy@your-server.example.com

3. Store the private key in the platform

1. Open Servers → add server → SSH (see Your own server).
2. Paste the complete contents of the private key file into SSH private key (including the BEGIN/END lines):

cat ~/.ssh/application-platform