Documentation / Your server
Servers Overview
How calmo.cloud connects to and manages your servers.
Servers are the foundation of your calmo.cloud setup. They are the machines where your Odoo instances run. calmo.cloud connects to your servers securely via SSH and handles all the technical setup automatically.
What does calmo.cloud do on my server? #
When you add a server to calmo.cloud, it automatically:
- Installs Docker — The technology that keeps each Odoo instance isolated and secure
- Sets up databases — PostgreSQL databases for your Odoo services
- Configures networking — A reverse proxy (Traefik) that routes web traffic to the right service
- Creates DNS records — A platform domain so services are instantly accessible
- Enables monitoring — Optional server metrics via Telegraf
- Frees up disk space every night — Removes unused Docker images, stale build cache and files left behind by interrupted copies, backups and restores, and keeps the system journal to 1 GB. Running services, databases and filestores are never touched.
You don't need to manually configure any of this.
Optional server features #
The server's settings have a tab for each feature you can add:
| Tab | What it adds |
|---|---|
| Telegraf | Server metrics and the data for metric alerts |
| Fail2ban | Blocks IP addresses after repeated failed SSH and Odoo logins. See Fail2ban. |
| Mail catcher | Keeps the emails that copies, previews and coding-agent copies send. See Emails sent by copies. |
| Log history | Keeps Odoo logs after the server has rotated them away. In early access. See Log history. |
Telegraf and fail2ban cannot be switched off once installed.
Server requirements #
To use a server with calmo.cloud, it must meet these minimum requirements:
| Requirement | Details |
|---|---|
| Operating system | Ubuntu 22.04 or newer (recommended) |
| SSH access | Root or sudo access via SSH |
| Open ports | 80 (HTTP), 443 (HTTPS), and 22 (SSH) |
| Resources | At least 2 GB RAM and 20 GB disk space per Odoo instance |
Most cloud providers (Hetzner, DigitalOcean, AWS, Vultr) offer servers that meet these requirements out of the box. calmo.cloud can also order servers directly from supported providers like Hetzner.
Server dashboard #
Each server in calmo.cloud shows you:
- Connection status — Whether calmo.cloud can reach the server
- Docker status — Whether Docker is installed and running
- Database status — Whether PostgreSQL is configured
- Proxy status — Whether Traefik is handling web traffic
- Running services — A list of all Odoo instances on this server
Multiple servers #
You can add as many servers as you need. Common setups include:
- Single server — Great for small teams or getting started
- Separate test and production servers — Keep test environments isolated from live ones
- Regional servers — Host instances closer to your users for better performance