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

Benefits:

• Use servers you already pay for
• Full control over location and specs
• Run multiple Odoo environments per server
• Access to all server management features

Shared Servers

Use OEC.sh managed infrastructure:

• No server management needed
• Automatic updates and security
• Pay only for what you use

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

Step 1: Get Server Details

You'll need:

• IP Address or hostname
• SSH credentials (username + password or SSH key)
• Server running Ubuntu 20.04+ or Debian 11+

Step 2: Add in Dashboard

1. Go to Servers in the sidebar
2. Click Add Server
3. Enter your server details:
   • Name: A friendly name (e.g., "Production Server")
   • Host: IP address or domain
   • Port: Usually 22
   • Username: root or sudo user
   • Authentication: Password or SSH key
4. Click Test Connection
5. If successful, click Add Server

Step 3: Server Preparation

OEC.sh automatically:

• Runs preflight checks
• Installs Docker
• Configures the firewall
• Sets up monitoring (Netdata)
• Prepares for Odoo deployments

This takes 2-3 minutes. You can track progress in the Readiness tab.

Server Status

Your server shows one of these statuses:

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
• Container resource consumption

Environments Tab

List of all environments deployed on this server

Cleanup Tab

Docker cleanup dashboard:

• Remove unused images
• Clean up stopped containers
• 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.

What's Next?

• Create a Project - Set up your first project
• Deploy an Environment - Get Odoo running
• Monitor Your Server - Track server health