## [1.1.9.1] - 2025-10-30 ## General This is an emergency hotfix release. PVE 8.x users may have encountered issues while installing or upgrading ProxLB on Debian systems, as well as on some systems using "older" Python versions may have thrown runtime errors due to a wrong quoting in f-strings. ## Changelog ### Fixed - Fix quoting in f-strings which may cause issues on PVE 8 / Debian Bookworm systems (@gyptazy). [#352] ## Downloads ### Debian Packages Download: https://cdn.gyptazy.com/debian/proxlb_1.1.9.1_all.deb SHA256: 7b88ba1caac72220d9bb52be1c5d24f40c7329ce7158a21d294f8ad212d83c73 proxlb_1.1.9.1_all.deb ### Debian Repository You can immediately start with this quick-start to add the repository and its signing key to obtain upcoming versions by apt on your system: ``` echo "deb https://repo.gyptazy.com/stable /" > /etc/apt/sources.list.d/proxlb.list wget -O /etc/apt/trusted.gpg.d/proxlb.asc https://repo.gyptazy.com/repository.gpg apt-get update && apt-get -y install proxlb cp /etc/proxlb/proxlb_example.yaml /etc/proxlb/proxlb.yaml # Adjust the config to your needs vi /etc/proxlb/proxlb.yaml systemctl start proxlb ``` You can also find additional information about the repository right [here](https://github.com/gyptazy/ProxLB?tab=readme-ov-file#quick-start). ### Docker Image Download AMD64: cr.gyptazy.com/proxlb/proxlb:v1.1.9.1 SHA256: d4f72fc339139a8a2504c30cd300aabea99e510df665826cb2ae62782ee0550c Download ARM64: cr.gyptazy.com/proxlb/proxlb-arm64:v1.1.9.1 SHA256: MISSING

## [1.1.7] - 2025-09-19 ### Added - Add conntrack state aware migrations of VMs (@gyptazy). [#305] - Add graceful shutdown for SIGINT (e.g., CTRL + C abort). (@gyptazy). [#304] ### Fixed - Fix crash when validating absent migration job ids. (@gyptazy). [#308] - Fix guest object names are not being evaluated in debug log. (@gyptazy). [#310] ## Downloads ### Debian Packages Download: https://cdn.gyptazy.com/debian/proxlb_1.1.7_all.deb SHA256: 8023a31eb833a845b560dc4181744eee1770918ade94a5137836b7dc5c1bca5c proxlb_1.1.7_all.deb ### Debian Repository You can immediately start with this quick-start to add the repository and its signing key to obtain upcoming versions by apt on your system: ``` echo "deb https://repo.gyptazy.com/stable /" > /etc/apt/sources.list.d/proxlb.list wget -O /etc/apt/trusted.gpg.d/proxlb.asc https://repo.gyptazy.com/repository.gpg apt-get update && apt-get -y install proxlb cp /etc/proxlb/proxlb_example.yaml /etc/proxlb/proxlb.yaml # Adjust the config to your needs vi /etc/proxlb/proxlb.yaml systemctl start proxlb ``` You can also find additional information about the repository right [here](https://github.com/gyptazy/ProxLB?tab=readme-ov-file#quick-start). ### Docker Image Download AMD64: cr.gyptazy.com/proxlb/proxlb:v1.1.7 SHA256: f7d6806b52089f59ed4189a60f9cec93981795ffc5de20247569b372004229da Download ARM64: cr.gyptazy.com/proxlb/proxlb-arm64:v1.1.7 SHA256: MISSING **Note**: Multiarch container images will be soon available. Please use until that time the suffix `-arm64` to get the arm64 compatible container image. You can also find the container image for arm64 [here](https://github.com/gyptazy/ProxLB/actions/runs/15752106709) or the already crafted multi-arch image [here](https://github.com/gyptazy/ProxLB/actions/runs/15752106718) which is not yet part of the container registry.

## [1.1.5] - 2025-07-14 ### Added - Allow custom API ports instead of fixed tcp/8006 (@gyptazy). [#260] ## Downloads ### Debian Packages Download: https://cdn.gyptazy.com/files/os/debian/proxlb/proxlb_1.1.5_all.deb SHA256: 65e1fde4d05b1d0e66e404b49a9c530f78a90c6a83a732b97bc70c2b227d3dca proxlb_1.1.5_all.deb ### Debian Repository You can immediately start with this quick-start to add the repository and its signing key to obtain upcoming versions by apt on your system: ``` echo "deb https://repo.gyptazy.com/stable /" > /etc/apt/sources.list.d/proxlb.list wget -O /etc/apt/trusted.gpg.d/proxlb.asc https://repo.gyptazy.com/repository.gpg apt-get update && apt-get -y install proxlb cp /etc/proxlb/proxlb_example.yaml /etc/proxlb/proxlb.yaml # Adjust the config to your needs vi /etc/proxlb/proxlb.yaml systemctl start proxlb ``` You can also find additional information about the repository right [here](https://github.com/gyptazy/ProxLB?tab=readme-ov-file#quick-start). ### Docker Image Download AMD64: cr.gyptazy.com/proxlb/proxlb:v1.1.5 SHA256: 56b1d57d118c3eedda8bc77c544da5274b9952be828fc23f54e0b9b5a2b5729b Download ARM64: cr.gyptazy.com/proxlb/proxlb-arm64:v1.1.5 SHA256: MISSING **Note**: Multiarch container images will be soon available. Please use until that time the suffix `-arm64` to get the arm64 compatible container image. You can also find the container image for arm64 [here](https://github.com/gyptazy/ProxLB/actions/runs/15752106709) or the already crafted multi-arch image [here](https://github.com/gyptazy/ProxLB/actions/runs/15752106718) which is not yet part of the container registry.

## [1.1.4] - 2025-06-27 ### Added - Allow pinning of guests to a group of nodes (@gyptazy). [#245] ### Fixed - Modified log levels to make output lighter at INFO level (@pmarasse) [#255] - Fixed an issue where balancing was performed in combination of deactivated balancing and dry-run mode (@gyptazy). [#248] ## Downloads ### Debian Packages Download: https://cdn.gyptazy.com/files/os/debian/proxlb/proxlb_1.1.4_all.deb SHA256: 22bb9c9557f8f03d9ac17fd770eb5db14e11a2884889db265bdc190748b71775 proxlb_1.1.4_all.deb ### Debian Repository You can immediately start with this quick-start to add the repository and its signing key to obtain upcoming versions by apt on your system: ``` echo "deb https://repo.gyptazy.com/stable /" > /etc/apt/sources.list.d/proxlb.list wget -O /etc/apt/trusted.gpg.d/proxlb.asc https://repo.gyptazy.com/repository.gpg apt-get update && apt-get -y install proxlb cp /etc/proxlb/proxlb_example.yaml /etc/proxlb/proxlb.yaml # Adjust the config to your needs vi /etc/proxlb/proxlb.yaml systemctl start proxlb ``` You can also find additional information about the repository right [here](https://github.com/gyptazy/ProxLB?tab=readme-ov-file#quick-start). ### Docker Image Download AMD64: cr.gyptazy.com/proxlb/proxlb:v1.1.4 SHA256: d869e6684442767f191acd85d8b181012d929ab3075b564d45515fcc164ba81d Download ARM64: cr.gyptazy.com/proxlb/proxlb-arm64:v1.1.4 SHA256: MISSING **Note**: Multiarch container images will be soon available. Please use until that time the suffix `-arm64` to get the arm64 compatible container image. You can also find the container image for arm64 [here](https://github.com/gyptazy/ProxLB/actions/runs/15752106709) or the already crafted multi-arch image [here](https://github.com/gyptazy/ProxLB/actions/runs/15752106718) which is not yet part of the container registry.

## [1.1.3] - 2025-06-29 ### Added - Add relaod (SIGHUP) function to ProxLB to reload the configuration (by @gyptazy). [#189] - Add optional wait time parameter to delay execution until the service takes action (by @gyptazy). [#239] - Make the amount of parallel migrations configurable (by @gyptazy). [#241] ### Changed - Use the average CPU consumption of a guest within the last 60 minutes instead of the current CPU usage (by @philslab-ninja & @gyptazy). [#94] ### Fixed - Align maintenance mode with Proxmox HA maintenance mode (by @gyptazy). [#232] ## Downloads ### Debian Packages Download: https://cdn.gyptazy.com/files/os/debian/proxlb/proxlb_1.1.3_all.deb SHA256: 04eb30bf37afba2eac7c5c38dd2ddb8c4e104e0571a57909b706f0e70d814450 proxlb_1.1.3_all.deb ### Debian Repository You can immediately start with this quick-start to add the repository and its signing key to obtain upcoming versions by apt on your system: ``` echo "deb https://repo.gyptazy.com/stable /" > /etc/apt/sources.list.d/proxlb.list wget -O /etc/apt/trusted.gpg.d/proxlb.asc https://repo.gyptazy.com/repository.gpg apt-get update && apt-get -y install proxlb cp /etc/proxlb/proxlb_example.yaml /etc/proxlb/proxlb.yaml # Adjust the config to your needs vi /etc/proxlb/proxlb.yaml systemctl start proxlb ``` You can also find additional information about the repository right [here](https://github.com/gyptazy/ProxLB?tab=readme-ov-file#quick-start). ### Docker Image Download AMD64: cr.gyptazy.com/proxlb/proxlb:v1.1.3 SHA256: 52e29e3825bb1cd399fc126324232e663a3dc50960707e50803a1c497cf606bb Download ARM64: cr.gyptazy.com/proxlb/proxlb-arm64:v1.1.3 SHA256: MISSING **Note**: Multiarch container images will be soon available. Please use until that time the suffix `-arm64` to get the arm64 compatible container image. You can also find the container image for arm64 [here](https://github.com/gyptazy/ProxLB/actions/runs/15752106709) or the already crafted multi-arch image [here](https://github.com/gyptazy/ProxLB/actions/runs/15752106718) which is not yet part of the container registry.

## [1.1.2] - 2025-05-13 ### Added - Add a configurable retry mechanism when connecting to the Proxmox API (by @gyptazy) [#157] - Add 1-to-1 relationships between guest and hypervisor node to ping a guest on a node (by @gyptazy) [#218] ### Fixed - Force type cast cpu count of guests to int for some corner cases where a str got returned (by @gyptazy). [#222] - Fix systemd unit file to run after network on non PVE nodes (by @robertdahlem) [#137] ## Downloads ### Debian Packages Download: https://cdn.gyptazy.com/files/os/debian/proxlb/proxlb_1.1.2_all.deb SHA256: 8d03bc518f45931a376dfd7d6c956d17d1995171e0dea73a637870598dcff042 proxlb_1.1.2_all.deb ### Debian Repository You can immediately start with this quick-start to add the repository and its signing key to obtain upcoming versions by apt on your system: ``` echo "deb https://repo.gyptazy.com/stable /" > /etc/apt/sources.list.d/proxlb.list wget -O /etc/apt/trusted.gpg.d/proxlb.asc https://repo.gyptazy.com/repository.gpg apt-get update && apt-get -y install proxlb cp /etc/proxlb/proxlb_example.yaml /etc/proxlb/proxlb.yaml # Adjust the config to your needs vi /etc/proxlb/proxlb.yaml systemctl start proxlb ``` You can also find additional information about the repository right [here](https://github.com/gyptazy/ProxLB?tab=readme-ov-file#quick-start). ### Docker Image Download: cr.gyptazy.com/proxlb/proxlb:v1.1.2 SHA256: 52aaba55cbc222bbfcae5c472d900d36feb987f5d2d62e2db5f679254990fad0

## [1.1.1] - 2025-04-20 ### Added - Providing the API upstream error message when migration fails in debug mode (by @gyptazy) [#205] ### Changed - Change the default behaviour of the daemon mode to active [#176] - Change the default banalcing mode to used instead of assigned [#180] ### Fixed - Set cpu_used to the cpu usage, which is a percent, times the total number of cores to get a number where guest cpu_used can be added to nodes cpu_used and be meaningful (by @glitchvern) [#195] - Fix tag evluation for VMs for being ignored for further balancing [#163] - Honor the value when balancing should not be performed and stop balancing [#174] - allow the use of minutes instead of hours and only accept hours or minutes in the format (by @glitchvern) [#187] - Remove hard coded memory usage from lowest usage node and use method and mode specified in configuration instead (by @glitchvern) [#197] - Fix the guest type relationship in the logs when a migration job failed (by @gyptazy) [#204] - Requery a guest if that running guest reports 0 cpu usage (by @glitchvern) [#200] - Fix Python path for Docker entrypoint (by @crandler) [#170] - Improve logging verbosity of messages that had a wrong servity [#165] ## Important The config file got updated and includes additional options and parameters for a more fine granular schedule. This must be updated after upgrading. **Example**: ``` service: daemon: True schedule: interval: 12 format: hours ``` You can find the full example in the given example config right [here](https://github.com/gyptazy/ProxLB/blob/v1.1.1/config/proxlb_example.yaml#L28-L32). ## Downloads ### Debian Packages Download: https://cdn.gyptazy.com/files/os/debian/proxlb/proxlb_1.1.1_all.deb SHA256: 7442f7cdc9fe06aa786092b3c9f9e8bf5ef0215a69d61a3b0664f4212f6290b1 proxlb_1.1.1_all.deb ### Debian Repository You can immediately start with this quick-start to add the repository and its signing key to obtain upcoming versions by apt on your system: ``` echo "deb https://repo.gyptazy.com/stable /" > /etc/apt/sources.list.d/proxlb.list wget -O /etc/apt/trusted.gpg.d/proxlb.asc https://repo.gyptazy.com/repository.gpg apt-get update && apt-get -y install proxlb cp /etc/proxlb/proxlb_example.yaml /etc/proxlb/proxlb.yaml # Adjust the config to your needs vi /etc/proxlb/proxlb.yaml systemctl start proxlb ``` You can also find additional information about the repository right [here](https://github.com/gyptazy/ProxLB?tab=readme-ov-file#quick-start). ### Docker Image Download: cr.gyptazy.com/proxlb/proxlb:v1.1.1 SHA256: 32e50bf834992b557c631b0601d2e30c2b16950df0359de8d22733ae4c2e7a18 ## Sponsors Businesses switching to Proxmox often seek a solution like this, and it’s great to see my company recognizing its value. Thanks to my company’s sponsorship, [I](https://gyptazy.com) get to contribute to this project under [credativ GmbH](https://credativ.de)’s (@credativ) commitment to open-source innovation.  At this point also a big thanks to all new committers: * @glitchvern * @sid3windr * @crandler * @mika And a special thanks to the people providing additional help for debugging issues by spending their time into re-creating setups and providing logs: * @bradyloveland

## Important This release introduces a complete code refactor of ProxLB, including a transition from INI-based configuration files to YAML, requiring users to adjust their configurations accordingly. The new YAML format enhances readability, flexibility, and scalability, but existing setups must be migrated to align with the updated schema. ## [1.1.0] - 2025-04-01 ### Added - ProxLB now only returns a warning when no guests for further balancing are present (instead of quitting) [#132] - Stop balancing when movement would get worste (new force param to enfoce for affinity rules) [#128] - Added requested documentation regarding Proxmox HA groups [#127] ### Changed - Refactored code base for ProxLB (by @gyptazy) [#114] - Config layout switched from ini to yaml style [#114] - Switched to `pycodestyle` for linting [#114] - Package building will be done within GitHub actions pipeline [#114] - All nodes (according to the free resources) will be used now [#130] - Rewrite of the whole affinity/anti-affinity rules evaluation and placement [#123] - Container image is now based on Alpine instead of Debian [#151] ### Fixed - Fix logging outputs where highest/lowest were mixed-up [#129] - Fix the `ignore` parameter for nodes where the node and guests on the node will be untouched [#102] - Fix the systemd unit file to start ProxLB after pveproxy (by @robertdahlem). [#137] ## Downloads ### Debian Packages Download: https://cdn.gyptazy.com/files/os/debian/proxlb/proxlb_1.1.0_all.deb SHA256: 05869116c7d4a8d3bf2e1a4f841c634e682ec3eb4ab68160668a1a7c3fcb9c55 proxlb_1.1.0_all.deb ### Debian Repository You can immediately start with this quick-start to add the repository and its signing key to obtain upcoming versions by apt on your system: ``` echo "deb https://repo.gyptazy.com/stable /" > /etc/apt/sources.list.d/proxlb.list wget -O /etc/apt/trusted.gpg.d/proxlb.asc https://repo.gyptazy.com/repository.gpg apt-get update && apt-get -y install proxlb cp /etc/proxlb/proxlb_example.yaml /etc/proxlb/proxlb.yaml # Adjust the config to your needs vi /etc/proxlb/proxlb.yaml systemctl start proxlb ``` You can also find additional information about the repository right [here](https://github.com/gyptazy/ProxLB?tab=readme-ov-file#quick-start). ### Docker Image Download: cr.gyptazy.com/proxlb/proxlb:v1.1.0 SHA256: 2e8ca88ae005a5d1aa2c8279a5fd14d5285e8c6b5330b70f0090e542eb8a4b12 ## Sponsors Businesses switching to Proxmox often seek a solution like this, and it’s great to see my company recognizing its value. Thanks to my company’s sponsorship, [I](https://gyptazy.com) get to contribute to this project under [credativ GmbH](https://credativ.de)’s (@credativ) commitment to open-source innovation.