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 -C "your_email@example.com"
   

   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. 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. Navigate to the Embassy > SSH.

2. Click “Add New Key”.

3. Paste in your SSH public key (created above) and click “Submit”.

Connecting via CLI (Linux/Mac)¶

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

   ssh root@<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¶