Skip to content
Shellbay

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

  1. 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: deploy

  2. Which 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

  1. Check the account
  2. Add the key
  3. 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.