logo
Nimbus uses SSH key pairs to authenticate access from a user’s computer (i.e. local machine) to Nimbus workspaces.
The process for SSH key setup differs based on the IDE you are using and if you are a first time user. In this doc, we cover all three cases.

Set up for JetBrains IDEs and all first-time users:

JetBrains IDE users will need to upload a public key via the Nimbus webapp before creating their workspace.
First-time users (those who have never connected to a a Nimbus workspace before)
See the steps below to learn how:
  1. Confirm that you have not already created keys on this computer
    1. Run ls ~/.ssh on your terminal
    2. If you see a similar output as the following then it means you already have keys created on your computer and you can jump to Step 3 directly.
      1. ➜  ~ ls ~/.ssh/
        config          id_ed25519.pub  id_rsa.pub      known_hosts.old
        id_ed25519      id_rsa          known_hosts
  1. Create a new pair of keys
    1. Run ssh-keygen -t ed25519 -C '<your email>' on your terminal at your home directory
    2. Follow the instructions to finish the creation process
      1. Note: the keys have to be saved under the ~/.ssh directory
    3. Confirm that keys are successfully created (see Step 1)
  1. Identify your public key:
    1. Run cat ~/.ssh/id_ed25519.pub on your terminal
    2. Save the output for later use.
  1. Go to the Account page on Nimbus webapp
  1. Scroll down to the “SSH Keys” section
  1. Add the public key you created above
  1. Confirm that you can see a new key record created under “SSH Keys” section.
    1. Image without caption
  1. Now you are good to go. You can now create a new workspace and connect to it via JetBrains IDE or VSCode

Set up for VSCode:

VSCode users do not need to set up SSH keys manually because the Nimbus extension does this for you during the connection to a Nimbus workspace from VSCode.
During this connection, the Nimbus VSCode extension creates a new SSH Key pair on your computer and passes the required key to the newly created workspace.
When this is done, a secure SSH tunnel can be established between your computer and the Nimbus workspace.