How to Securely Connect to Your Environment via SSH

This guide will take you through the steps to establish a secure SSH connection to manage your Bolt’s environments. This will enable you to manage your environments safely and effectively. Whether managing files, deploying applications, or troubleshooting issues, connecting via SSH protects your data.

First, you’ll need to check and verify your SSH access settings. Although optional, adding SSH keys to your setup can enhance your security. Finally, we’ll walk you through connecting to your environment using an SSH client, with specific instructions for Windows and Mac users.

Access Settings and Credentials

1. Navigate to your Bolts in the top-level menu.
2. Click the relevant Bolt.
3. Click the relevant Environment in the left-side menu to see the Environment Overview.
4. Click Access in the Environment menu.
5. Choose ‘Passwords and public keys’.

Login Information

To connect to your environment via SSH, you’ll need the specific login information, which can be found in the environment overview in the Admin Panel. The same information is also provided when an Environment is created. If you need to reset your SSH/SFTP password, you can do so by clicking “Reset SSH password”.

Connection Guide for macOS Terminal

1. Search for “Terminal” in Spotlight and open the Terminal application.
2. Click “Connect Securely via SSH” in the Login Information or the “Copy” icon.
3. Paste it into Terminal. Click Enter.
4. You will then be asked for a password unless you use an SSH key.
5. You should now be connected to the Environment!

Connection Guide for Windows via PuTTY

For a more thorough guide on connecting via PuTTY, you can check out our extensive guide.

1. You can use the PuTTY client on Windows. You can download it from Putty.org.
2. Launch the PuTTY client and navigate to “Session”. 
3. Copy the hostname from the login information and paste it to the “Host Name” section in PuTTY.
4. Check that the “Port” matches the one set in PuTTY.
5. Click Open in the bottom right.
6. Enter your SFTP/SSH Username.
7. You will be asked for a password unless you use an SSH key.
8. You should now be connected to the Environment!

As always, should you have any additional questions, please don’t hesitate to contact us through our support chat at servebolt.com!