This repository allows you to build and deploy a docker container for use with a proxmox cluster as an external qdevice. Properly configured proxmox clusters require an odd number servers in the cluster. In the event that you have an even number of proxmox servers (like 2, such as I have), you need an another device to vote. Proxmox supports this by allowing you to configure a qdevice for an external vote.
For more information on proxmmox clusters, external qdevices, and how to configure/use them, go here.
Run this container on a device that is NOT a virtual instance on one of your proxmox servers.
For full instructions on how to use and configure this container, please refer to USAGE.md.
This container image is based on Debian's "slim" images, for both Trixie (13) and Bookworm (12).
The QDevice software is installed from Debian's own software repositories.
The image contains a shell script and a Supervisord configuration created by this project's original author. This project is a fork of bcleonard/proxmox-qdevice.
Why a fork? The upstream project hasn't had an update in a year and it lacks weekly builds of the parent image, thus opening up your environment to long-lived vulnerabilities.
I have used this container image successfully with Proxmox 9.x and with Docker on Synology DSM 7.x.
This repository is based on original work by Bradley Leonard. Many thanks to his hard work!
Bradley's original wiki can be found here which contains all kinds of information on configuring this container.