SSH Keys
SSH keys let you authenticate with the platform securely when pushing and pulling code over Git SSH.
Generating an SSH Key
If you do not already have an SSH key pair, generate one using your terminal:
ssh-keygen -t ed25519 -C "your@email.com" Follow the prompts to save the key. The default location is ~/.ssh/id_ed25519.
Adding Your Key to the Platform
- Copy your public key to the clipboard:
- macOS:
cat ~/.ssh/id_ed25519.pub | pbcopy - Linux:
cat ~/.ssh/id_ed25519.pub | xclip -selection clipboard - Windows (Git Bash):
cat ~/.ssh/id_ed25519.pub | clip
- macOS:
- Go to your account settings.
- Paste the key into the SSH Key field and click Add Key.
Verifying Your Key
The platform's Git SSH endpoint only accepts Git commands, so an interactive test like ssh -T will not print a welcome message. Instead, verify your key by listing the refs
of a repository you have access to:
git ls-remote git@project113.com:your-username/your-repo.git If authentication succeeds you will see the repository's refs. If your key is not accepted, you
will see a Permission denied (publickey) error. If the repository does not exist
yet, you will get an error about the repository being unknown, but any message other than Permission denied (publickey) confirms your SSH key is accepted.
Managing Keys
You can add multiple SSH keys to your account. This is useful if you use multiple devices or machines. You can remove old or unused keys from the settings page at any time.