Getting Started
Add Your First Server

Add your first server

Servers host your Odoo environments. The fastest way to add one is Quick Connect — a single command that sets up everything automatically.

Server requirements

  • OS: Ubuntu 20.04+, Debian 11+ (Rocky/AlmaLinux also supported)
  • Root or sudo access
  • Internet connectivity (outbound HTTPS)

Minimum specs: 2 CPU cores, 4 GB RAM, 50 GB disk. That's enough for 3-5 small environments.

For production, aim for 4+ cores, 8+ GB RAM, 100+ GB SSD. A server that size handles 5-8 environments comfortably.

You do not need to pre-install Docker, configure firewall rules, or set up SSH keys. Quick Connect handles all of that for you.

Quick Connect (Recommended)

The fastest way to go from bare server to deploying Odoo. One command installs Docker, sets up the firewall, configures monitoring, and registers the server with OEC.SH — under 3 minutes, no SSH credentials needed.

Generate the install command

  1. Go to Servers in the sidebar
  2. Click Add Server
  3. Select Quick Connect
  4. Optionally set a server name and token expiry
  5. Click Generate Token

Run it on your server

Copy the install command and paste it into your server's terminal:

curl -sfL https://api.oec.sh/api/v1/install.sh | sudo OECSH_TOKEN=oecsh_reg_xxxx... bash
⚠️

The token is shown only once. If you lose it, revoke the token and generate a new one.

Watch it work

The script runs through 7 milestones — you can see progress both in your terminal and live in the OEC.SH dashboard:

  1. Register server (detects OS, CPU, RAM, disk)
  2. Secure server (SSH key, firewall, Fail2ban)
  3. Install Docker
  4. Configure system (swap)
  5. Set up monitoring (Netdata)
  6. Start services (Traefik reverse proxy)
  7. Verify and complete

Done — deploy your first environment

Once setup completes, your server appears as Qualified and is ready for Odoo deployments. The entire process typically takes 2-3 minutes.

For a full reference on token options, what gets installed, security details, and troubleshooting, see the Quick Connect guide.

Other Ways to Add a Server

If you already have SSH credentials and Docker installed, you can add a server manually:

  1. Go to Servers → Add Server → Connect BYOS
  2. Enter your server's IP address, SSH port, username, and authentication (password or SSH key)
  3. Click Test Connection, then Add Server

OEC.SH will run preflight checks and configure the server for deployments.

SSH keys are more secure than passwords. If you start with a password, you can upgrade later using the "One-Click Secure" feature, which generates a key pair and deploys it automatically.

Prerequisites for Direct SSH:

  • Docker 20.10+ installed and running
  • Ports open: 22 (SSH), 80 (HTTP), 443 (HTTPS)
# Install Docker if needed (Ubuntu/Debian)
curl -fsSL https://get.docker.com | sudo sh
 
# Open firewall ports
sudo ufw allow 22/tcp && sudo ufw allow 80/tcp && sudo ufw allow 443/tcp

Monitoring

OEC.SH deploys Netdata on your server for real-time metrics — CPU, memory, disk, network, and per-container resource usage. Quick Connect installs it automatically; for other methods, it's deployed when you create your first environment.

Common issues

Script fails at "Registering server" — Token is expired, already used, or invalid. Generate a new one from the dashboard.

"Connection refused" — Check that SSH is running (systemctl status sshd) and port 22 is open in your firewall.

"Authentication failed" — Double-check your password or SSH key. If using a key, make sure the public key is in ~/.ssh/authorized_keys on the server and permissions are set to 600.

"Docker not found" — Quick Connect installs Docker automatically. For Direct SSH, install Docker manually: curl -fsSL https://get.docker.com | sudo sh

Server shows "Needs Setup" — Click Fix Issues in the server detail page and OEC.SH will install missing components for you.

Next steps

  1. Configure storage — Set up where backups go
  2. Create a project — Connect your Git repo
  3. Deploy an environment — Get Odoo running
Create Account & OrganizationConfigure Storage Provider