OS Compatibility
Supported operating systems and version requirements for OEC.sh managed servers.
Supported Operating Systems
OEC.sh supports the following Linux distributions:
| Distribution | Versions | Support Status |
|---|---|---|
| Ubuntu | 20.04 LTS, 22.04 LTS, 24.04 LTS | Fully Supported |
| Debian | 11 (Bullseye), 12 (Bookworm) | Fully Supported |
| Rocky Linux | 8, 9 | Fully 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
| Resource | Minimum | Recommended |
|---|---|---|
| CPU | 2 cores | 4+ cores |
| RAM | 4 GB | 8+ GB |
| Disk | 80 GB | 200+ GB SSD |
| Architecture | x86_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 Version | Python Version | PostgreSQL Version |
|---|---|---|
| 18.0, 19.0 | 3.10+ | 14, 15, 16 |
| 17.0 | 3.10+ | 14, 15, 16 |
| 16.0 | 3.8 - 3.11 | 12, 13, 14, 15 |
| 15.0 | 3.7 - 3.10 | 12, 13, 14 |
| 14.0 | 3.6 - 3.9 | 10, 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 Version | wkhtmltopdf Version | Notes |
|---|---|---|
| 17.0+ | 0.12.6 (with patched Qt) | Included in OEC.sh containers |
| 14.0 - 16.0 | 0.12.5 or 0.12.6 | Included in OEC.sh containers |
OEC.sh containers include the correct wkhtmltopdf version with patched Qt for proper header/footer rendering.
Network Requirements
Required Ports
| Port | Protocol | Purpose |
|---|---|---|
| 22 | TCP | SSH access (required for OEC.sh management) |
| 80 | TCP | HTTP traffic (redirects to HTTPS) |
| 443 | TCP | HTTPS traffic |
Optional Ports
| Port | Protocol | Purpose |
|---|---|---|
| 8069 | TCP | Direct Odoo access (bypassing proxy) |
| 8072 | TCP | Odoo longpolling (WebSocket) |
| 5432 | TCP | PostgreSQL (if external access needed) |
| 19999 | TCP | Netdata dashboard |
See Firewall & Ports for detailed configuration.
Cloud Provider Compatibility
OEC.sh works with any cloud provider that offers Linux VMs:
| Provider | Tested | Notes |
|---|---|---|
| Hetzner | Yes | Excellent price/performance, EU locations |
| DigitalOcean | Yes | Simple setup, global locations |
| AWS EC2 | Yes | Requires security group configuration |
| Google Cloud | Yes | Requires firewall rule configuration |
| Azure | Yes | Requires NSG configuration |
| Linode | Yes | Good pricing, multiple regions |
| Vultr | Yes | Bare metal and cloud options |
| OVHCloud | Yes | EU-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:
| Configuration | Reason |
|---|---|
| Windows Server | OEC.sh requires Linux |
| macOS | Server use only, not desktop OS |
| ARM64 architecture | x86_64 only (ARM support planned) |
| Ubuntu < 20.04 | End of life, security concerns |
| Debian < 11 | End of life, security concerns |
| CentOS 7/8 | End of life |
| Shared hosting | Root/sudo access required |
Checking Your System
Verify OS Version
# Ubuntu/Debian
cat /etc/os-release
# Any Linux
uname -aVerify Architecture
uname -m
# Should output: x86_64Verify Resources
# CPU cores
nproc
# Memory
free -h
# Disk space
df -hTroubleshooting
"Unsupported OS" Error During Provisioning
Cause: OS version is not in the supported list.
Solution:
- Upgrade to a supported version, or
- Create a new server with a supported OS
Docker Installation Fails
Cause: Existing Docker installation or conflicting packages.
Solution:
- Remove existing Docker:
sudo apt remove docker docker-engine docker.io containerd runc - Re-run OEC.sh provisioning
Low Memory Warnings
Cause: Server RAM is below recommended threshold.
Solution:
- Upgrade server RAM, or
- Configure swap space (see server setup guides), or
- Reduce number of environments on the server
Need Help?
If you're unsure about compatibility:
- Email: [email protected]
- Include: OS version, server specs, cloud provider