Qm-socket-proxy
Dedicated authenticated Docker API proxy required by Quartermaster Companion.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
76/100 Good
- Maintained
- 100last commit 0 days ago
- Popular
- 54488 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 95no serious findings, CI, tests
Based on 4 of 5 factors.
Availability: platform listings confirmed today, links checked 18 days ago
- GitHub stars
- 488
- Open issues
- 14
- Last commit
- 2026-11-21
- Latest release
- 1.14.0
- Activity
- rising
Checked today - source: GitHub (wollomatic/socket-proxy)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- First Install Install the container from the Unraid 'qm-companion' apps network. Keep the default container name, enter the generated QM_PROXY_KEY, and leave Docker writes and Container shell set to 0. source
- Traefik Compatibility When using Traefik 2.11.31 or later, add the startup argument -allowHEAD=/_ping so the Docker provider can retrieve the API version through the proxy. source
Fetched today - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What Traefik option must be added when using Qm-socket-proxy with Traefik 2.11.31 or 3.6.1 and later?
Add -allowHEAD=/_ping to the Socket-Proxy configuration so Traefik can make HEAD requests to /_ping. Without it, Traefik may fall back to Docker API version 1.51 and break the Docker provider on older Docker versions.
How should Qm-socket-proxy be installed in Unraid for Quartermaster Companion?
Install it from the qm-companion apps network, keep the default container name, enter the generated QM_PROXY_KEY, and leave Docker writes and Container shell set to 0.
Is it safe to publish Qm-socket-proxy on the internet?
No. The project says to never expose it to a public network and to use it only in a secure environment.
How does Qm-socket-proxy limit the Docker API calls a client can make?
It uses an allowlist configured separately for each HTTP method with Go regular expression syntax, and in bridge network mode each container can have its own allowlist plus IP address-based access control.
Which image tag is recommended for production use?
Use a pinned version tag such as 1.13.1, or the 1 tag if you want the most recent version without a breaking deployment change. The testing tag is not recommended for production.
Answers sourced from ca.unraid.net, github.com
Community
- Monitoring docker swarm nodes via socket-proxy - Reddit (reddit)
- Unable to connect to VM qmp socket - Proxmox Support Forum (forum)
Collected 49 days ago - public community threads