Using SSH¶

Creating an SSH Key (Linux/Mac)¶

1. Open a terminal and enter the following command, replacing the example email address with your own (or, alternatively, a comment):

   ssh-keygen -t ed25519
   

   You will be asked to Enter a file in which to save the key - we recommend you press Enter to use the default location

2. Create a strong passphrase and save it somewhere safe, or press Enter for no passphrase

3. It will inform you that your public key has been saved. Take note of this path:

   Your public key has been saved in /home/user/.ssh/id_ed25519.pub
   

4. Next, start your system’s ssh-agent and add your key to it:

   eval "$(ssh-agent -s)"
   ssh-add ~/.ssh/id_ed25519
   

   Note that if you changed the file name/location in step 1, you will need to use that file/path in this step

Registering an SSH Key¶

1. In your Embassy’s web interface, navigate to Embassy > SSH.

2. Click “Add New Key”.

3. Back in the terminal of your workstation, display and copy your SSH public key (created above):

   cat ~/.ssh/id_ed25519.pub
   

4. Copy the whole resulting line that looks similar to:

   ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAINH3tqX71XsPlzYhhoo9CqAP2Yx7gsGTh43bQXr1zqoq user@ema.il
   

5. Paste that line into the Add New Key text field of your Embassy

   

6. Click Submit

You are now ready to SSH into your Embassy!

Connecting via CLI (Linux/Mac)¶

1. You can now access your Embassy from the command line (Linux and Mac) using:

   ssh start9@<LAN URL>
   

Replacing <LAN URL> with your Embassy’s LAN (embassy-xxxxxxx.local) address

Connecting via PuTTY on Windows¶

Community member BrewsBitcoin has created a guide for connecting via SSH using PuTTY on Windows.

Using SSH Over Tor¶