All Collections › Clusters & Servers › Using a VPS from Hostinger, Contabo, netcup and other hosts

Using a VPS from Hostinger, Contabo, netcup and other hosts

Add a server from a budget VPS host to a cluster as a custom server

Updated

Hosts like Hostinger, Contabo, netcup and OVHcloud's VPS range sell servers by the month or year at low prices, but without an API Hatchbox integrates with. You can still run apps on them with Hatchbox: create the server with your host, then add it to a cluster with the Custom provider.

Create the server

  • Choose a supported operating system: Ubuntu 26.04, 24.04, 22.04 or 20.04, or Debian 13 or 12. We recommend the newest Ubuntu LTS your host offers. Pick a plain OS image, not one with a control panel like cPanel or Plesk installed.
  • Give it at least 1 GB of memory, or 2 GB if it will build and run a Rails app with its database on the same server.
  • Add your SSH key while creating the server if your host offers it. Otherwise, log in with the root password your host sends and add the key yourself.

Log in as root

Hatchbox logs in as root. Most budget hosts give you root access directly. Some images, like Ubuntu on OVHcloud VPS, log you in as ubuntu instead: run sudo -i to become root before the next step.

Add the server to Hatchbox

Create a cluster with the Custom provider, or open an existing one, and add a server:

  • Public IP: the server's IPv4 address from your host.
  • Private IP: 127.0.0.1 if it's the cluster's only server. Most budget hosts don't give servers a private network by default. If yours offers one and you add it, enter that address; otherwise enter the public IP. Hatchbox only lets your own servers reach the database ports.
  • SSH Port: 22, unless you changed it.

Hatchbox logs in as root with an SSH key. On the server's page in Hatchbox, open How to connect a server to Hatchbox, copy the command that adds the Hatchbox SSH key, and run it on the server as root. Then click Test connection. Once it connects, Hatchbox sets up the server: it turns off password logins, configures the firewall and installs what the server's roles need.

Your host's firewall

If your host has a firewall in its control panel, allow SSH (22) and, on web servers and load balancers, HTTP (80) and HTTPS (443). Hatchbox manages the firewall on the server itself, and connects over SSH from the addresses listed in Hatchbox IP Addresses.

What's different from a provider Hatchbox creates servers on

  • Deleting the server in Hatchbox only removes it from Hatchbox. Cancel it with your host when you're done with it.
  • Hatchbox can't autoscale a custom server's role, since it can't create new ones.
  • Budget hosts often limit network speed or share CPU between customers more than cloud providers do, so check your host's plan details if your app is busy.