Skip to content

Documentation / Your server

Adding a Server

Step-by-step guide to connecting a server to calmo.cloud.

calmo.cloud 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 calmo.cloud 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 calmo.cloud 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 calmo.cloud can connect to your server. You should see a green status indicator.

4. Install Docker #

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

5. Set up infrastructure #

On the server's configuration page, enable Postgres and Traefik in the infrastructure tabs and save. calmo.cloud installs and configures both for you.

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