Guide: SSH

Key Pair Generation and Import

Generating an SSH Key Pair Locally

🐧 Linux / 🍎 macOS

Open a terminal and run the following command:

ssh-keygen -t rsa -b 4096 -f ~/.ssh/myKey

When prompted, enter a secure passphrase. Record it safely — without it, you won't be able to use the key pair.

This creates two files:

• Private key: ~/.ssh/myKey
• Public key: ~/.ssh/myKey.pub

Note: If you copy the key pair to or from another system, ensure that the private key has correct (restricted) permissions:

chmod 600 ~/.ssh/myKey

Now you can import your public key into the Dashboard.

---

🪟 Windows

Open Command Prompt (Click the Start menu, type cmd into the search bar and press Enter). Then run the following commands:

mkdir C:\Users\%USERNAME%\.ssh

ssh-keygen -t rsa -b 4096 -f C:\Users\%USERNAME%\.ssh\myKey

When prompted, enter a secure passphrase. Record it safely — without it, you won't be able to use the key pair.

This creates two files:

• Private key: C:\Users\%USERNAME%\.ssh\myKey

• Public key: C:\Users\%USERNAME%\.ssh\myKey.pub

Note: If you copy the key pair to or from another system, ensure that the private key has correct (restricted) permissions:

icacls "%USERPROFILE%\.ssh\myKey" /inheritance:r /grant:r "%USERNAME%:(R,W)"

Now you can import your public key into the Dashboard.

---

Importing an Existing SSH (Public) Key via Dashboard

To use a key you generated on your device:

1. Log in to the Dashboard.
2. Go to: Project → Compute → Key Pairs.
3. Click Import Public Key.
4. In the dialog:
   • Enter a unique name.
   • Make sure SSH Key is selected as the key type.
   • Upload your public key file (e.g., myKey.pub) or paste the contents of it.
5. Click Import Public Key.

Your public key name should now appear in the list and is ready for use.

---

Creating an SSH Key Pair via Dashboard

If you don’t have a key pair yet or prefer using the Dashboard:

1. Log in to the Dashboard.
2. Go to: Project → Compute → Key Pairs.
3. Click Create Key Pair.
4. In the dialog:
   • Enter a unique name.
   • Make sure SSH Key is selected as the key type.
5. Click Create Key Pair.

The public key name should now appear in the list and the private key will be automatically downloaded — save it securely, as you won’t be able to download it again.

---

Advanced SSH Configuration

Once you have generated and imported your SSH key pair, you can simplify and improve your SSH experience by creating a personal SSH configuration file. This file, typically located at ~/.ssh/config, lets you store connection details, reuse existing connections, and keep sessions stable — all of which are especially useful when managing multiple OpenStack instances.

Organizing and Simplifying SSH Connections

Instead of remembering long commands, you can define named host entries in your SSH configuration file.

Host myVM
    HostName 134.155.111.111
    User ubuntu
    IdentityFile ~/.ssh/myKey

You can now connect simply with:

ssh myVM

Explanation:

• Host — a nickname for your connection
• HostName — the actual IP address or DNS name of the instance
• User — the default login username
• IdentityFile — path to your private key (if not the default `id_rsa`)

This approach helps you manage multiple instances with short, readable aliases.

Reusing Existing SSH Connections (ControlMaster)

If you frequently connect to the same instance, SSH can reuse a single network connection instead of opening new ones each time. This reduces connection overhead and speeds up subsequent logins.

Host myVM
    ...
    ControlMaster auto
    ControlPersist 1h
    ControlPath ~/.ssh/master-%C

Explanation:

• ControlMaster auto — enables connection sharing automatically
• ControlPersist 1h — keeps the master connection open for one hour after the last session ends
• ControlPath — specifies the socket file used for multiplexing (the `%C` variable creates a unique hash per connection)

Tip: With these options, once you connect to myVM once, further SSH or SCP commands to the same host will reuse that connection and start instantly.

Keeping Connections Alive

Long-running SSH sessions can sometimes time out due to network inactivity. To prevent this, configure SSH to send periodic keepalive messages.

Host myVM
    ...
    ServerAliveInterval 60
    ServerAliveCountMax 3
    TCPKeepAlive yes

Explanation:

• ServerAliveInterval 60 — sends a keepalive message every 60 seconds
• ServerAliveCountMax 3 — disconnects only after three unanswered keepalives (≈3 minutes)
• TCPKeepAlive yes — uses low-level TCP keepalive as an additional safeguard

This ensures stable, long-lasting sessions even over less reliable networks.

Troubleshooting Frozen SSH Sessions

Occasionally, SSH master connections can freeze or hang, especially after network interruptions. In such cases, you can manually terminate or clean up the stale connection.

a) Identifying and killing master processes

List all master sockets and their processes:

lsof -U 2>/dev/null | grep master-

Terminate the corresponding processes:

kill -9 <PID>

b) Removing stale master socket files

Delete leftover socket files:

rm ~/.ssh/master-*

After cleanup, new SSH connections will automatically establish fresh master sessions.