Default Settings
All defaults can be overridden in the DEFAULT section of the configuration file or per-container via Tiers.
Scaling parameters
| Parameter | Default | Description |
|---|---|---|
poll_interval | 300 | Seconds between scaling cycles. |
cpu_upper_threshold | 80 | CPU % triggering scale-up. |
cpu_lower_threshold | 20 | CPU % triggering scale-down. |
memory_upper_threshold | 80 | Memory % triggering scale-up. |
memory_lower_threshold | 20 | Memory % triggering scale-down. |
memory_exclude_cache | true | Exclude reclaimable page cache from reported memory usage. Shared memory (tmpfs, /dev/shm, shm segments) is not excluded, because it is swap-backed and cannot be reclaimed on a container without swap; this is why the figure can read higher than the Proxmox UI, which subtracts the file total whole. Set false to count all page cache as used, which is the pre-2.0.2 behaviour. |
min_cores | 1 | Minimum CPU cores per container. |
max_cores | 4 | Maximum CPU cores per container. |
min_memory | 512 | Minimum memory (MB) per container. |
core_min_increment | 1 | Minimum cores added per scale-up. |
core_max_increment | 2 | Maximum cores added per scale-up. |
memory_min_increment | 256 | Minimum MB added per memory scale-up. |
min_decrease_chunk | 128 | Minimum MB removed per memory scale-down. |
Host reservation
| Parameter | Default | Description |
|---|---|---|
reserve_cpu_percent | 10 | % of host CPU cores never allocated to containers. |
reserve_memory_mb | 2048 | MB of host memory reserved. |
Energy mode
| Parameter | Default | Description |
|---|---|---|
off_peak_start | 22 | Hour (24h) when off-peak begins. |
off_peak_end | 6 | Hour (24h) when off-peak ends. |
energy_mode | false | Reduce to minimums during off-peak. Enable via --energy_mode flag. |
timezone | UTC | IANA timezone for off-peak scheduling (e.g., Europe/Rome). |
Behaviour multiplier
| Value | Multiplier | Effect |
|---|---|---|
conservative | 0.5x | Slower, smaller scaling steps. |
normal | 1.0x | Default behaviour. |
aggressive | 2.0x | Faster, larger scaling steps. |
Backend selection
| Parameter | Default | Description |
|---|---|---|
backend | cli | cli for pct commands (local or SSH), api for Proxmox REST API. |
SSH (remote CLI backend)
| Parameter | Default | Description |
|---|---|---|
use_remote_proxmox | false | Execute pct commands on a remote host via SSH. |
proxmox_host | IP or hostname of the remote Proxmox host. | |
ssh_user | SSH username. | |
ssh_password | SSH password. Prefer ssh_key_path or env var LXC_AUTOSCALE_SSH_PASSWORD. | |
ssh_key_path | Path to SSH private key. | |
ssh_port | 22 | SSH port. |
ssh_host_key_policy | reject | reject (verify host keys), system (warn on unknown), auto (deprecated). |
Proxmox REST API backend
| Parameter | Default | Description |
|---|---|---|
proxmox_api.host | Proxmox host IP or hostname. | |
proxmox_api.user | Proxmox user (e.g., root@pam or autoscale@pve). | |
proxmox_api.token_name | API token name. | |
proxmox_api.token_value | API token secret. Use env var ${PROXMOX_API_TOKEN}. | |
proxmox_api.verify_ssl | true | Verify SSL certificates when connecting to the API. |
File paths
| Parameter | Default |
|---|---|
log_file | /var/log/lxc_autoscale.log |
lock_file | /var/lock/lxc_autoscale.lock |
backup_dir | /var/lib/lxc_autoscale/backups |
Container exclusion
| Parameter | Description |
|---|---|
ignore_lxc | List of container IDs to exclude from all scaling operations. |