# Qm-socket-proxy

Qm-socket-proxy is a self-hosted tools & utilities app. Dedicated authenticated Docker API proxy required by Quartermaster Companion. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3240/qm-socket-proxy

## Description

Dedicated authenticated Docker API proxy required by Quartermaster Companion. It keeps the Docker socket out of the main application and does not publish a host port.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

76/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 0 days ago)
- Popular: 54 (488 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 95 (no serious findings, CI, tests)

## Links

- Unraid: https://ca.unraid.net/apps/qm-socket-proxy-0jy41ze12jmap2?q=qm-socket-proxy
- GitHub: https://github.com/wollomatic/socket-proxy

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/3240/qm-socket-proxy), the self-hosted and open-source app directory.
