Users & Access · about 1 min · 3 steps
Add an SSH key
Lets someone sign in to an existing account with their SSH key.
Runs on
- Debian / Ubuntu: supported
- RHEL / Fedora: supported
- Alpine: supported
What it changes on your server
- Adds the key to the account's ~/.ssh/authorized_keys, unless it's already there. Other keys are kept.
- Creates ~/.ssh if needed, owned by the account, with the permissions SSH requires.
What Shellbay asks you
Which account gets the key?
The existing account the person will sign in as. Run List user accounts to see them. System accounts such as root aren't accepted.
- Account
- A new Linux account name
Example:
deployWhich key?
Paste one public key line. In Shellbay, open Keys, choose a key and copy its public key. Private keys never leave the device they were made on.
- Public key
- One SSH public key line
Example:
ssh-ed25519 AAAAC3Nz… alice@laptop
Steps
- Check the account
- Add the key
- Check the key is authorized
Shellbay checks the server before the first step, and stops at the first step that fails.
When it's done
- The key can sign in as ‹account›. In Shellbay, add a host for ‹account› with that key and connect once to check.