Guides
OS Compatibility

OS Compatibility

Supported operating systems and version requirements for OEC.sh managed servers.


Supported Operating Systems

OEC.sh supports the following Linux distributions:

DistributionVersionsSupport Status
Ubuntu20.04 LTS, 22.04 LTS, 24.04 LTSFully Supported
Debian11 (Bullseye), 12 (Bookworm)Fully Supported
Rocky Linux8, 9Fully Supported

Recommendation: Ubuntu 22.04 LTS is recommended for new deployments due to its long-term support (until 2027) and excellent package availability.


Minimum Requirements

System Requirements

ResourceMinimumRecommended
CPU2 cores4+ cores
RAM4 GB8+ GB
Disk80 GB200+ GB SSD
Architecturex86_64 (AMD64)x86_64 (AMD64)

Software Requirements

OEC.sh automatically installs these components during server provisioning:

  • Docker - Container runtime (latest stable)
  • Docker Compose - Container orchestration
  • Netdata - Real-time monitoring (optional, but recommended)
⚠️

Clean Installation Required: OEC.sh expects a fresh server without existing Docker installations. Existing Docker setups may conflict with OEC.sh provisioning.


Odoo Version Compatibility

Odoo Version → Python Requirements

Odoo VersionPython VersionPostgreSQL Version
18.0, 19.03.10+14, 15, 16
17.03.10+14, 15, 16
16.03.8 - 3.1112, 13, 14, 15
15.03.7 - 3.1012, 13, 14
14.03.6 - 3.910, 11, 12, 13

Container-Based: OEC.sh runs Odoo in Docker containers with the correct Python and PostgreSQL versions pre-configured. The host OS Python version doesn't affect Odoo.


wkhtmltopdf Compatibility

wkhtmltopdf is required for generating PDF reports in Odoo.

Odoo Versionwkhtmltopdf VersionNotes
17.0+0.12.6 (with patched Qt)Included in OEC.sh containers
14.0 - 16.00.12.5 or 0.12.6Included in OEC.sh containers

OEC.sh containers include the correct wkhtmltopdf version with patched Qt for proper header/footer rendering.


Network Requirements

Required Ports

PortProtocolPurpose
22TCPSSH access (required for OEC.sh management)
80TCPHTTP traffic (redirects to HTTPS)
443TCPHTTPS traffic

Optional Ports

PortProtocolPurpose
8069TCPDirect Odoo access (bypassing proxy)
8072TCPOdoo longpolling (WebSocket)
5432TCPPostgreSQL (if external access needed)
19999TCPNetdata dashboard

See Firewall & Ports for detailed configuration.


Cloud Provider Compatibility

OEC.sh works with any cloud provider that offers Linux VMs:

ProviderTestedNotes
HetznerYesExcellent price/performance, EU locations
DigitalOceanYesSimple setup, global locations
AWS EC2YesRequires security group configuration
Google CloudYesRequires firewall rule configuration
AzureYesRequires NSG configuration
LinodeYesGood pricing, multiple regions
VultrYesBare metal and cloud options
OVHCloudYesEU-focused, competitive pricing

On-Premises / Bare Metal

OEC.sh also supports:

  • Dedicated servers (any provider)
  • On-premises hardware
  • Virtual machines (VMware, Proxmox, KVM)
⚠️

Internet Access Required: The server must have outbound internet access to pull Docker images and receive updates.


Unsupported Configurations

The following are not supported:

ConfigurationReason
Windows ServerOEC.sh requires Linux
macOSServer use only, not desktop OS
ARM64 architecturex86_64 only (ARM support planned)
Ubuntu < 20.04End of life, security concerns
Debian < 11End of life, security concerns
CentOS 7/8End of life
Shared hostingRoot/sudo access required

Checking Your System

Verify OS Version

# Ubuntu/Debian
cat /etc/os-release
 
# Any Linux
uname -a

Verify Architecture

uname -m
# Should output: x86_64

Verify Resources

# CPU cores
nproc
 
# Memory
free -h
 
# Disk space
df -h

Troubleshooting

"Unsupported OS" Error During Provisioning

Cause: OS version is not in the supported list.

Solution:

  1. Upgrade to a supported version, or
  2. Create a new server with a supported OS

Docker Installation Fails

Cause: Existing Docker installation or conflicting packages.

Solution:

  1. Remove existing Docker:
    sudo apt remove docker docker-engine docker.io containerd runc
  2. Re-run OEC.sh provisioning

Low Memory Warnings

Cause: Server RAM is below recommended threshold.

Solution:

  1. Upgrade server RAM, or
  2. Configure swap space (see server setup guides), or
  3. Reduce number of environments on the server

Need Help?

If you're unsure about compatibility:

  • Email: support@oec.sh
  • Include: OS version, server specs, cloud provider