Import Your Existing SSH Hosts: OpenSSH Config or PuTTY

To import your existing SSH hosts from OpenSSH config or PuTTY into ShellSage, simply tap the import icon on the Hosts screen, paste your configuration, and choose which hosts to bring over.

Why Import Your SSH Hosts?

Managing multiple SSH connections can quickly become cumbersome, especially if you're juggling several servers. Importing your existing SSH hosts from OpenSSH or PuTTY into ShellSage streamlines this process. This allows you to access your frequently used servers without needing to input each connection manually, saving you valuable time and reducing the risk of errors.

"A well-organized SSH host list can be a game-changer for productivity, especially when troubleshooting or deploying updates."

Additionally, ShellSage offers features like Sage, your AI assistant, which can help explain command outputs and suggest fixes if something goes wrong. This is particularly useful when you're working from a mobile device, where screen space is limited and typing can be cumbersome.

How Do You Import SSH Hosts?

The process of importing your SSH hosts into ShellSage is straightforward and user-friendly. First, ensure that you have your OpenSSH config or PuTTY export file handy. If you're using an OpenSSH config, it typically resides in the ~/.ssh/config directory on your local machine. For PuTTY, you can export your sessions to a file that ShellSage can read.

Once you have your configuration ready, follow these steps:

1. Open the ShellSage app and navigate to the Hosts screen.
2. Tap the import icon, located next to the + button.
3. Paste your OpenSSH config or select your PuTTY export file.
4. Tap the Scan button to let ShellSage analyze your input.

"With just a few taps, you can bring in all your saved hosts and be ready to connect instantly."

After tapping Scan, ShellSage will display a list of the servers it found in your configuration. You can then review this list and select which hosts you want to import into your ShellSage environment.

What Options Do You Have During Import?

When you import your SSH hosts, ShellSage provides you with some options to streamline the connection process. One of the key options is to add a single key or password for all the imported hosts. This can be particularly useful if your servers utilize the same authentication method.

If you prefer to manage your keys more granularly, you can choose to add keys later when you first connect to each server. This flexibility allows you to maintain security while still benefiting from the convenience of having all your hosts in one place.

ssh user@host

For instance, if you have a key stored in your device, you can use it when connecting to your server by specifying the key file with the -i option:

ssh -i /path/to/your/key user@host

What to Expect After Importing?

Once you've imported your SSH hosts into ShellSage, you'll find that connecting to them is a breeze. The app organizes your hosts in a clean and user-friendly interface, allowing you to quickly identify the server you need to access. Simply tap on the desired host to initiate an SSH connection.

As you work within ShellSage, you can take advantage of Sage, your AI assistant. If you encounter any command output that you don’t understand, simply ask Sage for clarification. For example, if you run a command that returns an error, you can ask, "What does this error mean?" and Sage will provide an explanation.

"Sage transforms the way you interact with command outputs, making it easier to troubleshoot on the go."

Additionally, ShellSage includes a blast-radius preview feature before executing potentially dangerous commands. This ensures that you have a clear understanding of the consequences of your actions, reducing the risk of accidental data loss or system misconfigurations.

Common Issues and Troubleshooting

While the process of importing SSH hosts into ShellSage is generally smooth, you may encounter some common issues. One potential problem is if your OpenSSH config contains unsupported options or syntax that ShellSage cannot parse. In such cases, it's advisable to review your configuration file for any unusual entries.

If you experience issues connecting to an imported host, double-check your authentication method. Ensure that the correct key is available on your device or that you're using the correct password. ShellSage allows you to adjust these settings when you first connect to each server.

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

For creating a new SSH key if you don't have one, you can use the above command. This generates a new RSA key pair, which you can then add to your SSH agent and use for authentication.