Getting Started

Contents

  1. Quick-Connect with your Server Password (30 seconds)
  2. Normal Setup with your Server Password (1 minute)
  3. Normal Setup without a Server Password (5 minutes)

Are you using SSH or Shellvault for the first time? This page will walk you through the basics of connecting to your remote server with Shellvault. Here's what you'll need:

  • Your server address: usually an IP address (like 151.101.188.201), but can also be a standard domain name like shellvault.io.
  • Your connection credentials: a username and password.
  • If you don't wish to share your user password with Shellvault (read our security page for more details), you'll need an ssh terminal utility. It's easy to install on Mac and Linux (most Linux systems have ssh pre-installed), and you can use something like Cmder or PuTTY on Windows.

Check out our FAQ for more info or if you run into any issues.

Quick-Connect with your Server Password (30 seconds)

  1. Head to the Shellvault main interface, close any open tabs, and click on "Quick Start".

    Quick start button

    You can get to the same dialog from an open tab by clicking the Not Connected button (or the big server icon), then "Quick New Server".

    Not connected Quick new server

  2. Type in your SSH server credentials, then hit Enter or click "Connect".

    Shellvault will set up the new key for you without recording your password. Read more here.

    Quick connect to a new server

  3. Type Yes in the prompt that asks "Are you sure you want to continue connecting?", then hit Enter.

    This step tells Shellvault to remember an identifier for the server, so that you'll notice if another server ever appears at the same address.

    Are you sure you want to continue connecting (yes/no)?
    
  4. You're now connected with SSH! Next time you need to connect, you can click on the server's name on the empty tab page...

    Quick connect to a server

    ...or click on the Not Connected button (or the big server icon) in a new tab or pane.

    Not connected

Normal Setup with your Server Password (1 minute)

  1. Head to the Shellvault settings page. You can get there from the Shellvault main interface by clicking the settings icon in the top-right corner.

    Settings button

  2. From the Servers tab, click on the "Create New" button.

    Create a new server

  3. Enter your server credentials, then click "Set up key for me".

    Type your server's user password, and finally hit Enter or click "Save Server". Shellvault will set up the new key for you without recording your password (see our FAQ for details).

    If you'd rather set up the SSH key yourself, skip ahead to the next section without typing your password.

    Deploy a key automatically

    You can also deploy a key by clicking on Keys > Deploy key to server in the server management table.

    Deploy a key from the servers table

  4. Head back to the Shellvault main interface and click on the server's name.

    Quick connect to a server

  5. Type Yes for the prompt that asks "Are you sure you want to continue connecting?", then hit Enter. Read about "SSH host key verification" if you're curious about what this does.

    Are you sure you want to continue connecting (yes/no)?
    
  6. You're now connected with SSH!

Normal Setup without a Server Password (5 minutes)

  1. Follow the previous section up to step 3, but click "Set up key myself" instead.

    Deploy a key yourself

  2. Choose whichever remote setup option works best for you. You'll need to use the Keys dropdown on the Servers menu:

    Copy deploy command

    • Linux and MacOS users: you can run the ssh-copy-id command provided on the Keys > Deploy Key to Server dialog. You can also copy the key's contents into to shellvault-key.pub before running ssh-copy-id yourself:

      $ ssh-copy-id -fi shellvault-key.pub your_user@your.server.com
      
    • Windows users: use an SSH utility like Cmder or PuTTY to SSH into your server and edit ~/.ssh/authorized_keys. Paste the contents of your public key into the bottom of the file.

  3. Head back to the Shellvault main interface and click on the server's name.

    Quick connect to a server

  4. Type Yes in the prompt that asks "Are you sure you want to continue connecting?", then hit Enter.

    This step tells Shellvault to remember an identifier for the server, so that you'll notice if another server ever appears at the same address.

    Are you sure you want to continue connecting (yes/no)?
    
  5. You're now connected with SSH!