Skip to main content

​
What you’ll need

Make sure you have:
  • An active Compute instance
  • Your instance ID (from the Hivenet dashboard)
  • Your private SSH key (.pem or .ed25519 file you downloaded)
  • A Mac with Terminal (you’ll find it in Spotlight)

​
Step 1: Find your instance ID

In the Hivenet dashboard, copy your instance ID (looks like ba184ade-84ed...). You’ll use this when connecting.

​
Step 2: Open Terminal

Press Cmd + Space, type Terminal, and hit Return to open it. To keep things tidy and secure, move your downloaded key to your Mac’s SSH folder. In Terminal, run these commands one by one:
Replace /path/to/your-key.pem with the actual path to the key you downloaded.

​
Step 4: Connect to your instance

Open the instance’s connectivity details in Compute and copy the SSH command shown there. Compute exposes a stable SSH endpoint for each instance on port 22, so use the current command from the console rather than reconstructing the address yourself. A typical command looks like:
  1. Replace /path/to/your-key.pem with your key file location if needed.
  2. Use the hostname and username shown for your instance in Compute.
  3. The default username is usually ubuntu, depending on the selected image.

​
Step 5: Accept the connection

On first connect, you’ll see a message like:
Type yes and hit Return.

​
You’re in

You’ll land in your instance’s terminal, ready to install packages, run apps, or start a Jupyter notebook.
If you already use 1Password, you can store and use SSH keys directly—no need to manage files or worry about permissions. Here’s how SSH with 1Password works.

​
Troubleshooting tips

  • Permission denied (publickey)?
    • Make sure the path to your .pem file is correct and that it’s set to chmod 600.
  • Connection times out?
    • Try restarting your instance. Some networks block SSH—if this keeps happening, ask us for help with an alternate connection method.