Servers

Servers are the infrastructure that runs your Odoo environments. OEC.sh connects to your servers and manages everything for you.

Server Types

Your Own Servers (BYOS)

Bring any Linux server you already have:

• VPS from DigitalOcean, Hetzner, Linode, AWS
• Dedicated servers
• On-premise hardware

You get full control over location and specs, can run multiple Odoo environments per server, and have access to all server management features.

Shared Servers

Use OEC.sh managed infrastructure. No server management needed -- automatic updates and security.

Note: Shared servers show limited information in the dashboard. You can deploy and manage environments on them, but cannot access server management features like terminal, metrics, or SSH settings.

Add a Server

Quick Connect (Recommended)

The fastest way to add a server — one command does everything:

1. Go to Servers → Add Server → Quick Connect
2. Copy the install command
3. Run it on your server

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

The script automatically installs Docker, configures the firewall, sets up monitoring, and registers the server — no SSH credentials needed upfront. Setup completes in under 3 minutes, and you can watch progress live in the dashboard.

Direct SSH (Alternative)

If you prefer to provide SSH credentials yourself:

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. You'll need to have Docker pre-installed.

Cloud Provisioning

Provision a new server directly from a connected cloud account (AWS, DigitalOcean, Hetzner, etc.) in Settings → Cloud Accounts.

Server Status

Server Detail Page

Click on a server name to view its detail page with four tabs:

Readiness Tab

Shows preflight checks and server qualification status:

• System requirements validation
• Docker installation status
• Network configuration
• Any issues that need fixing

Metrics Tab

Real-time server monitoring:

• CPU, memory, and disk usage
• Network traffic
• Per-environment resource consumption

Environments Tab

List of all environments deployed on this server

Cleanup Tab

Server cleanup dashboard:

• Remove unused resources
• Free disk space

Server Actions

From the server detail page, you can:

• Terminal: Open an SSH terminal directly in your browser
• Test Connection: Verify SSH connectivity
• Edit: Update server name, notes, or SSH credentials
• Delete: Remove the server from OEC.sh

Note: These actions are only available for your own servers (BYOS). Shared servers have limited management options.

Test Connection

If your server shows as stopped or offline:

1. Go to Servers
2. Click on your server
3. Click Test Connection button
4. Check the result message

Common issues:

• Server is powered off
• IP address changed
• SSH credentials expired
• Firewall blocking port 22

Remove a Server

Warning: Removing a server removes all environments on it from OEC.sh. Back up your data first!

1. Stop all environments on the server
2. Create backups of important data
3. Go to Servers and click on your server
4. Click Delete button
5. Confirm deletion

For cloud-provisioned servers, you can optionally also delete the server from your cloud provider.

The server itself is not deleted from your cloud provider unless you specifically choose that option.

Server Requirements

Minimum Specs

Supported Operating Systems

• Ubuntu 20.04 LTS or newer
• Debian 11 or newer
• Rocky Linux 8 or newer

Network Requirements

These ports must be accessible:

• 22 - SSH access
• 80 - HTTP traffic
• 443 - HTTPS traffic

Multiple Environments per Server

One server can run multiple Odoo environments:

• Small server (4GB RAM): 1-2 environments
• Medium server (8GB RAM): 3-5 environments
• Large server (16GB+ RAM): 5-10 environments

OEC.sh shows you remaining capacity when creating new environments.