Docsgetting startedssh access

SSH setup

Connect to a machine over SSH.

You can generate SSH key pairs and connect to your Mars Machine from your preferred terminal or code editor.

Configure networking with Tailscale before setting up SSH. SSH access depends on the private Tailscale connection.

Step 1 of 5

Generate an SSH key pair

Create an ed25519 key on your local machine and keep the public key ready to copy.

$ ssh-keygen -t ed25519 -C "advait@getmars.computer"

Generating public/private ed25519 key pair.
Enter file in which to save the key (/Users/advait/.ssh/id_ed25519):
Enter passphrase for "/Users/advait/.ssh/id_ed25519" (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in test
Your public key has been saved in id_ed25519.pub
The key fingerprint is:
SHA256:SoH9ELyhAar+ZDnrcyqq4B0BgxxpcwyMQXSm3RrAOGI advait@getmars.computer
The key's randomart image is:
+--[ED25519 256]--+
|OB=+ ..          |
|BEBoooo.         |
|**oo.++o         |
|. o + .+         |
|.  o  . S        |
|.   o. .         |
|.. *  .          |
|o.=.+.           |
|=.o*+            |
+----[SHA256]-----+

ssh mars-user@[MACHINE_NAME] works because mars-user is the default configured user and [MACHINE_NAME] is a valid hostname for Tailscale to route the traffic to the correct machine.

Adding machines to config

Step 1 of 2

Open your SSH config

Edit ~/.ssh/config on your local machine to add the Mars Machine alias

Code editors

Step 1 of 2

Open the remote SSH command

Use your editor's remote SSH workflow or command palette to start a new SSH connection.