Congratulations with your new Hypernode! To access it, you need to use an SSH client.

This tutorial shows how to log in to the Hypernode with PuTTY (for Windows users) or Terminal (Linux and Mac OSX) using SSH.

NB: If you want to create SSH keys, please read the article: Create SSH Keys on Hypernode.

For Windows users

Login using PuTTY

To use PuTTY you need to download this program from the PuTTY website. To connect to Hypernode you’ll have to use your SSH hostname (name.hypernode.io) and username (app).

‘How To’ for Dutch users

If you ordered your Hypernode trial or hosting plan via Byte.nl, your SSH connection settings can be found in the Byte Service Panel. Use the following steps to connect to Hypernode.

  • In the Byte Service Panel select your Hypernode (name.hypernode.io), go to Instellingen and click Shell Toegang. The required credentials are listed under SSH gegevens
  • Open to PuTTY
  • Navigate to Session and enter your hostname (or IP address) in the Host name field
    • This should be the name of your Hypernode plan: name.hypernode.io
  • Click Open
  • Enter app as your username
  • Enter your password (it’s the same as the “Technisch Beheerder” login password for the Service panel)
  • Congrats! You can now access your Hypernode.

‘How To’ for English speaking users

If you ordered your Hypernode plan or trial via Hypernode.com, you received your SSH hostname and IP address via email as soon as your Hypernode is ready for use.

  • Open to PuTTY
  • Navigate to Session and enter your hostname (or IP address) in the Host name field
    • This should be the name of your Hypernode plan: name.hypernode.io
  • Click Open
  • Enter app as your username
  • Congrats! You can now access your Hypernode.

Login using the Windows Subsystem for Linux on Windows 10

If you are on Windows 10 and a more experienced user, you can install the Windows Subsystem for Linux.
This way you can simply install the bash shell and all needed GNU Utils to create an environment similar to the hypernode.
To do this, use this excellent howto on howtogeek

For Linux and Mac OSX users

Login using Terminal (Linux) or iTerm2 (MacOS)

‘How To’ for Dutch users

If you ordered your Hypernode trial or hosting plan via Byte.nl, your SSH connection settings can be found in the Byte Service Panel. Use the following steps to connect to Hypernode.

Where name is the name you have chosen when you ordered the Hypernode. If the name of your node is example.hypernode.io the command would be like this:

Press ‘Enter’.

Optional: enter your password (it’s the same as the “Technisch Beheerder” login password for the Service panel). Press ‘Enter’ again. Congrats! You now accessed your Hypernode.

‘How To’ for English speaking users

If you ordered your Hypernode plan or trial via Hypernode.com, you received your SSH hostname and IP address via email as soon as your Hypernode is ready for use.
Use the following command to connect to Hypernode:

Where name is the name you have chosen when you ordered the Hypernode. If the name of your node is example.hypernode.io the command would be like this:

Press ‘Enter’. Congrats! You now accessed your Hypernode

Dutch users only: disabling password authentication

More experienced SSH users often want to fully disable password authentication on the Hypernode.
This can be done through your Service Panel by disabling password logins on SSH.

To do this, select Instellingen -> Shell toegang.
From there click the Uitschakelen button in the section Inloggen via wachtwoord:

Brute force protection

We enabled fail2ban on the hypernode, which is a tool that detects bruteforces by tailing the remote access logs (/var/log/auth.log). IP’s that try more then 6 times to login within 20 minutes will be added to the firewall for an hour.

It is possible that you ban your own IP through fail2ban because of extensive testing. You can manage your own whitelist of IP’s that fail2ban needs to ignore. The IP’s added to the WAF whitelist will be completely ignored by fail2ban. If you happen to get blocked yourself, add your IP address to the WAF whitelist.

All users: via the hypernode-systemctl tool

You can easily whitelist IP addresses via the command line. First, run the following to check if any IP’s are already whitelisted:

Adding to whitelist

To add more values to your whitelists you can run the following. Please note that descriptions are optional:

Removing from whitelist

To remove values from your whitelists you can run the following:

Dutch users only: via your Service Panel

Only Dutch customers (Byte.nl) have the option to add an IP address to the WAF whitelist via their Service Panel. The steps:

  1. Log on to your Service Panel
  2. Select your Hypernode
  3. Go to ‘Instellingen’
  4. Select ‘WAF whitelist’
  5. Add IP address and description
30