Adding a Server

Step-by-step guide to connecting a server to hav.sh.

hav.sh supports two ways to add a server:

  • Manual — Enter the IP address of an existing server you've already set up
  • Cloud Provider — Order a new server directly from a supported cloud provider like Hetzner

If you want hav.sh to order and set up a server for you, see Cloud Providers instead.

#Adding a server manually

#Before you begin

You'll need:

  1. A server (VPS) from a cloud provider like Hetzner, DigitalOcean, or AWS
  2. The server's IP address
  3. An SSH private key that has access to the server

If you don't have an SSH key yet, see SSH Keys for instructions on creating one.

#1. Go to Servers

In the hav.sh sidebar, click Servers, then click the New Server button. Select Manual as the creation method.

#2. Enter server details

Fill in the following fields:

  • Name — A friendly name to identify this server (e.g., "Production EU")
  • IP Address — The public IP address of your server
  • Port — The SSH port, usually 22
  • Username — The SSH user, usually root
  • SSH Private Key — Select a previously added key, or add a new one

#3. Test the connection

Click Check Reachability to verify hav.sh can connect to your server. You should see a green status indicator.

#4. Install Docker

If Docker is not yet installed, hav.sh will offer to install it for you. Click Install Docker and wait for the process to complete.

#5. Set up infrastructure

hav.sh will also set up the database server (PostgreSQL) and reverse proxy (Traefik). These are configured automatically.

Your server is now connected and ready to host Odoo services.

#Managing public keys

If multiple team members need SSH access to the server, you can manage Public Keys from the server settings. These keys are synchronized to the server's authorized keys, controlling who can connect directly.

#Troubleshooting

Connection fails
  • Verify the IP address is correct
    • Make sure port 22 is open in your server's firewall
    • Confirm the SSH key has been added to the server's authorized_keys
    • Check that the username is correct (usually root)
Docker installation fails
  • Ensure the server has internet access
    • Check that the server is running a supported operating system (Ubuntu 22.04+)
    • Try connecting to the server manually via SSH to verify access
Overview Cloud Providers