Skip to content

Default Settings

All defaults can be overridden in the DEFAULT section of the configuration file or per-container via Tiers.

Scaling parameters

ParameterDefaultDescription
poll_interval300Seconds between scaling cycles.
cpu_upper_threshold80CPU % triggering scale-up.
cpu_lower_threshold20CPU % triggering scale-down.
memory_upper_threshold80Memory % triggering scale-up.
memory_lower_threshold20Memory % triggering scale-down.
min_cores1Minimum CPU cores per container.
max_cores4Maximum CPU cores per container.
min_memory512Minimum memory (MB) per container.
core_min_increment1Minimum cores added per scale-up.
core_max_increment2Maximum cores added per scale-up.
memory_min_increment256Minimum MB added per memory scale-up.
min_decrease_chunk128Minimum MB removed per memory scale-down.

Host reservation

ParameterDefaultDescription
reserve_cpu_percent10% of host CPU cores never allocated to containers.
reserve_memory_mb2048MB of host memory reserved.

Energy mode

ParameterDefaultDescription
off_peak_start22Hour (24h) when off-peak begins.
off_peak_end6Hour (24h) when off-peak ends.
energy_modefalseReduce to minimums during off-peak. Enable via --energy_mode flag.
timezoneUTCIANA timezone for off-peak scheduling (e.g., Europe/Rome).

Behaviour multiplier

ValueMultiplierEffect
conservative0.5xSlower, smaller scaling steps.
normal1.0xDefault behaviour.
aggressive2.0xFaster, larger scaling steps.

Backend selection

ParameterDefaultDescription
backendclicli for pct commands (local or SSH), api for Proxmox REST API.

SSH (remote CLI backend)

ParameterDefaultDescription
use_remote_proxmoxfalseExecute pct commands on a remote host via SSH.
proxmox_hostIP or hostname of the remote Proxmox host.
ssh_userSSH username.
ssh_passwordSSH password. Prefer ssh_key_path or env var LXC_AUTOSCALE_SSH_PASSWORD.
ssh_key_pathPath to SSH private key.
ssh_port22SSH port.
ssh_host_key_policyrejectreject (verify host keys), system (warn on unknown), auto (deprecated).

Proxmox REST API backend

ParameterDefaultDescription
proxmox_api.hostProxmox host IP or hostname.
proxmox_api.userProxmox user (e.g., root@pam or autoscale@pve).
proxmox_api.token_nameAPI token name.
proxmox_api.token_valueAPI token secret. Use env var ${PROXMOX_API_TOKEN}.
proxmox_api.verify_ssltrueVerify SSL certificates when connecting to the API.

File paths

ParameterDefault
log_file/var/log/lxc_autoscale.log
lock_file/var/lock/lxc_autoscale.lock
backup_dir/var/lib/lxc_autoscale/backups

Container exclusion

ParameterDescription
ignore_lxcList of container IDs to exclude from all scaling operations.

Released under the MIT License.