Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

SSH

Like other Linux distributions, StartOS allows you to go "under-the-hood" via Secure Shell Protocol (SSH).

Warning

Accessing your server via SSH is considered advanced. Please use caution, you can cause permanent damage to your server, potentially resulting in loss of data.

Contents

Using your StartOS Master Password

  1. Open a terminal on your client device and enter:

    ssh start9@SERVER-HOSTNAME

    Replace SERVER-HOSTNAME with your server's adjective-noun.local address URL.

  2. Enter your StartOS master password.

  3. The first time you connect, you will see something like this:

    The authenticity of host 'adjective-noun.local (192.168.1.175)' can't be established.

ED25519 key fingerprint is SHA256:BgYhzyIDbshm3annI1cfySd8C4/lh6Gfk2Oi3FdIVAa.

This key is not known by any other names.

Are you sure you want to continue connecting (yes/no/[fingerprint])?

    Type "yes" and hit Enter to start trusting the server's SSH public key.

    Note

    If you get a scary looking warning that says something like

    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!

    Fear not! This is most likely happening because you have recently re-flashed your server, which causes a change in the key for your device's hostname. The solution is to delete the existing entry from your known_hosts file, which is typically located at ~/.ssh/known_hosts. This will be specified in the warning, along with a helpful line number (in case your file is lengthy).

Using SSH Keys

  1. In the StartOS UI, go to System > SSH

  2. Click Add Key, paste in your key and click Save

  3. Open a terminal on your client device and enter:

    ssh start9@SERVER-HOSTNAME

    Replace SERVER-HOSTNAME with your server's adjective-noun.local address URL.

  4. Enter your key's passphrase (if any)

  5. The first time you connect, you will see something like this:

    The authenticity of host 'adjective-noun.local (192.168.1.175)' can't be established.

ED25519 key fingerprint is SHA256:BgYhzyIDbshm3annI1cfySd8C4/lh6Gfk2Oi3FdIVAa.

This key is not known by any other names.

Are you sure you want to continue connecting (yes/no/[fingerprint])?

    Type "yes" and hit Enter to start trusting the server's SSH public key.

Connecting via PuTTY on Windows

For Windows, following the command above will work. But if you prefer a GUI tool, BrewsBitcoin has created a guide for connecting via SSH using PuTTY on Windows