Automatic Resource Tuning

When you resize your server or want Odoo and PostgreSQL settings aligned with available CPU and RAM, use tuning.

Commands

soviez.sh --tune --dry-run
soviez.sh --tune --explain
soviez.sh --tune

Flag	Purpose
--dry-run	Show the planned changes without applying them
--explain	Show how values were calculated
(none)	Apply safe sizing and restart only if required

What tuning does

detect resources → calculate safe limits → compare with current → present plan → apply → validate

On failure, Soviez restores the previous known-good configuration.

What gets sized

• Odoo — workers, cron threads, memory and time limits, proxy mode, gevent port when multi-worker
• PostgreSQL — buffers, work memory, connections, WAL and checkpoint settings
• Docker — shared memory for PostgreSQL within the total memory budget

Soviez sizes runtime configuration from available server resources. Internal formulas may change between platform releases; they are not public SLAs.

Headroom

Sizing leaves room for PostgreSQL, the operating system, filesystem cache, Nginx, Docker, security scanners, backups, Stage workloads, and scheduled tasks.

Idempotency

Running --tune twice without a resource change produces no effective changes and avoids unnecessary restarts.

When to run

• After upgrading VPS RAM or CPU
• After adding Stage environments on the same host
• When ERP feels slow and you have confirmed the server is not disk- or network-bound

Related

• REQUIREMENTS.md
• TROUBLESHOOTING.md