Docs - Instance Setup


Linux/MacOS #

Quickstart #

On Ubuntu or Mac, first you need to generate an rsa ssh public/private keypair using the command:

ssh-keygen -t rsa

Next you may need to force the daemon to load the new private key, and confirm it's loaded:

ssh-add; ssh-add -l

Then get the contents of the public key with:

cat ~/.ssh/

Copy the entire output to your clipboard, then paste that into the "Change SSH Key" text box under console/account. The key text includes the opening "ssh-rsa" part and the ending "user@something" part. If you don't copy the entire thing, it won't work.

example SSH key text:

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAZBAQDdxWwxwN5Lz7ubkMrxM57CHhVzOnZuLt5FHi7J8zFXCJHfr96w+ccBOBo2rtBBTTRDLnJjIsKLgBcC3+jGyZhpUNMFRVIJ7MeqdEHgHFvUUV/uBkb7RjbyyFcb4BCSYNggUZkMNNoNgEa3aqtBSzt47bnuGqKszs9bfACaPFtr9Wo0b8p4IYil/gfOY5kuSVwkqrBCWrg53/+T2rAk/02mWNHXyBktJAu1q9qTWcyO68JTDd0sa+4apSu+CsJMBJs3FcDDRAl3bcpiKwRbCkQ+N63ol4xDV3zQRebUc98CJPh04Gnc41W02lmdqFL2XG5U/rV8/JM7CawKiIz3dbkv bob@velocity

You can use a few SSH keys by pasting in each on a new line.

Troubleshooting #

If you encounter "Permission denied (publickey)", then the most likely causes are:

  • you are trying to run an ssh or scp command from inside the instance
  • didn't setup your keys correctly or using the wrong/mismatched keys
  • used incorrect/unsupported ssh key format
  • didn't actually load your private key correctly with ssh-add, may need to use -i argument
  • changed the key on the account page too recently (can take a minute or two to propagate)
  • incorrect permissions on your ssh key

You can usually determine the exact cause by using the -vv arguments with ssh to get more info.


We connect you to a tmux session by default for reliability. You can create a new bash terminal window with "ctrl+b,c" (press ctrl and b, followed by c), and switch with "ctrl+b,n". But google "tmux cheat sheet" or "tmux guide" for more info.

You can disable tmux by with:

touch ~/.no_auto_tmux;

(In a bash terminal or in your onstart)

Windows #

Windows 10+ has native SSH support if you use the Windows Powershell to both generate the ssh key and to connect to the instance. Otherwise, windows does not support native ssh key generation or connection. This guide covers free Windows tools that can generate SSH keys, SSH into Vast instances and transfer files back and forth between the Windows machine and instances.

Most machine learning and AI programming is done on Linux. We recommend biting the bullet and installing a Linux subsystem on your Windows machine, like WSL.

Windows Powershell #

Windows offers typical SSH access through the Powershell. The typical SSH linux commands will work in the Powershell.

Step 1 - Open the Windows Powershell terminal #

Click on the search bar in the bottom right and type in Powershell. Click on the Windows Powershell icon to open up a new session.

Step 2 - Run the SSH Key generation command if you do not already have a default ssh key (id_rsa) #

Run the ssh key generation command in the terminal.

ssh-keygen -t rsa

You will be prompted to enter a file in which to save the key. Hit enter to save in the default directory. You will then be prompted for a passphrase. For simplicity, hit enter to for no passphrase.

Next you will need to copy the contents of the public SSH key to paste into your Vast account. Use the following command to output the public key and copy it to your clipboard:

Get-Content $env:USERPROFILE/.ssh/ | Set-Clipboard

Step 3 - Add SSH Key To Account #

Navigate to the account page of Vast and go to the Change SSH Key section. There you can add the ssh key you just generated to your account.

Any instances you create will now have your ssh key attached to the instance. This only applies to new instances. Existing instances will NOT have your ssh key and you will have to add it manually to the instance.

Step 4 - Find the SSH connection string #

Go to the instances page and look for a bright blue button that says 'Open SSH Interface' on the instance card.

Click it and you should see a screen similar to this:

The connecting string we want is

ssh -p 42114 root@ -L 8080:localhost:8080

Find that string for the instance you want to SSH into. Copy it to your clipboard.

Step 5 - Connect via Powershell #

Copy the SSH connection string into Powershell. When it prompts you for anything just say 'yes'.

If you see yourself logged into a container you have connected successfully!

Windows Putty Guide #

Alternatively you can use Windows Putty tootls.

Here is a video guide for those who prefer a video walkthrough.

The Tools #

Puttygen.exe: A key generator used to create an RSA keypair

Putty.exe: The SSH client used to connect to the instance

Winscp: A GUI for scp to allow for file transfer to/from the instance

Step 1 - Establish SSH Keys #

Start by downloading and running the appropriate version of Puttygen.exe.

Make sure that the RSA key type is selected and then hit the "Generate" button. You will move your mouse cursor around to generate some randomness for the key. Then select the entire Public key (double check you get every character starting with ssh) and copy it to the clipboard like this:

Now login to your Vast account. Paste the contents of your clipboard in the "Change SSH Key" section and hit the blue SET SSH KEY button. Your new SSH key is now set for all new instances and will be propagated to running instances after 15ish minutes.

Go back to Puttygen. You will need to change the key format before you can save the private key. At the top level menu select Key->Parameters for saving key files. That will pop up the dialog. Change the PPK file version to 2. Hit OK to save the change.

Now you can hit the "Save private key" button to save your private key into a local folder. Ignore the passphrase warning. Remember where you store the key as you will need to specify the path to the key when using Putty.

Step 2 - SSH into a Vast instance #

Now that you have your SSH keys setup, it is time to rent an instance. First make sure you have added credits to your account. Then go to the create instance page and click on the Edit Image & Config in the upper left of the interface to specify the OS Image and type.

Typical OS Images such as Pytorch are preloaded. Select an empty template slot to use a custom OS Image. Pick if you want Jupyter installed or to run it as an SSH instance. Then select if you want direct connections are not. While direct connections are faster, you will limit the machines you see to ones only with open ports. Use the rest of the filters to search for GPU type, number of GPUs and other machine specifics.

Once you find a machine you like and rent it, the OS Image will start to load on it. Afterwards you will get connection information for the proxy connection only or both the proxy and direct. You will need the port number, which appears after the -p and the hostname.

Open up Putty.exe. You can then entire the hostname and port into the Putty client.

You will also need to select your private key file, by selecting SSH->Auth->Credentials on the left hand menu and then select your key file that you saved in step 1.

The final step is to save your session information. Navigate back to the session information pane, type in a name in the Saved Session box and then hit Save. Your keypath, hostname and IP address should now all be saved under that name and will be readable by WinSCP.

After saving the key it is easy to hit the Open button which will connect Putty. However once you close that session, the session information is lost. Navigate back to the Session tab and save the session before opening the connection.

Hit open to open up your SSH connection. The terminal will ask to add the key fingerprint (type yes) and then connect to the instance. You are in!

Step 3 - WinSCP for file transfer #

The final tool you will want to use with Windows is WinSCP.

If you saved your session information in Putty, the setup is trivial in WinSCP. It will simply import your Putty session information and then allow you to connect to that instance!

Once the session information is imported, simply hit the Login button to authenticate with the instance and then start transferring files by dragging them and dropping them between your local machine and the instance.

Let us know if you found this guide helpful and how we could improve.