Socket Proxy: what it is, which apps need it and what to do when it stops
Socket Proxy is a small helper app that Deployrr installs from the Docker menu. Traefik, the Deployrr Dashboard and many other apps need it. This guide shows what it does, how to install it, which apps need it and what to do when it is not running.
Overview
Section titled “Overview”Docker apps that watch or manage other containers need to talk to Docker. Many guides give each of those apps full access to Docker by mounting the Docker socket into it.
Deployrr does it another way for its core apps and most dashboard and monitoring apps. Socket Proxy is the container that touches the Docker socket. Those apps ask Socket Proxy for what they need. Socket Proxy only answers the requests it allows, so each app gets less power than direct access. A few apps still mount the Docker socket themselves.
To see what Socket Proxy does and how it is built by hand, watch Ultimate Docker Server: Docker Socket Proxy at 15:40 (manual setup, Deployrr does these steps for you). For background on how apps reach the Docker socket, read UDMS part 14: Socket Proxy and how apps reach the Docker socket (manual setup).
You install it once. After that, the apps that need it find it on their own. There is no web page for it and nothing to log in to.
Install Socket Proxy
Section titled “Install Socket Proxy”Before you start
Section titled “Before you start”- You finished Prerequisites. See the Quick start and Prerequisites, step by step.
- You have a Basic, Plus or Pro license. See Licenses.
- Start Deployrr.
- Choose Docker from the main menu.
- Look at the Socket Proxy line. It ends with one of these:
NOT INSTALLED: you have not installed it yet.RUNNING: it is installed and running.STOPPED: it is installed but not running. See When Socket Proxy is not running.
- Choose Socket Proxy. The line reads
Setup Socket Proxy. - In the Socket Proxy Installation box, read the text. Choose Yes to install.
- Wait while Deployrr works. You see these steps in the terminal:
Checking requirements..., thenAll requirements metCopying configuration files...Starting Socket Proxy container...Waiting for Socket Proxy to initialize..., thenSocket Proxy is running
- Look for
Socket Proxy installed successfully!.
To see the older Deployrr 5 install, watch Deployrr 5 walkthrough: Socket Proxy setup at 26:13 (Deployrr v5, menus and steps differ in v6).
If Socket Proxy is already installed, Deployrr asks first. The box is titled Already Installed. It says socket-proxy is already running or socket-proxy is already installed. It tells you that reinstalling stops the existing container, recreates it with the latest image and keeps your data volumes. Choose Yes only if you want that.
Check it worked
Section titled “Check it worked”- Go back to the Docker menu.
- The Socket Proxy line ends with
RUNNING.
The main menu also shows a status next to Docker. It reads DONE when both Socket Proxy and the Deployrr Dashboard are running. It reads PARTIAL when only one is running. It reads INCOMPLETE when one is installed but neither is running. It shows nothing before you install either one.
If Deployrr stops with a box
Section titled “If Deployrr stops with a box”- License Required: you see
This app requires a Basic, Plus, or Pro license.Upgrade, run Prerequisites > Verify, then try again. See Licenses. - Requirements Not Met: finish what the box lists, then try again. See Deployrr shows “Requirements Not Met”.
Socket Proxy deployment failed: the install did not finish. Read the messages above it in the terminal. For a timeout, see Deployrr times out waiting for a container to start.is malformed (missing placeholders): your main compose file is damaged. See Docker environment setup fails with: docker-compose file is malformed.
Which apps need Socket Proxy
Section titled “Which apps need Socket Proxy”Deployrr checks for Socket Proxy before it installs these. If it is missing, you see a box or a message instead of an install.
Traefik and login apps
Section titled “Traefik and login apps”These show a Requirements Not Met box with this line:
Socket Proxy - Must be running (Docker menu)- Proxy > Traefik > Preparation, Staging and Production
- Proxy > Traefik > Manage Exposure, Traefikify, Un-Traefikify, Domain Passthrough and Auth Bypass
- Security > Authelia, Authentik, Google OAuth and TinyAuth (these also need a Pro license)
See Set up Traefik for the full Traefik order.
Deployrr Dashboard and apps from Browse Apps
Section titled “Deployrr Dashboard and apps from Browse Apps”These show a message in the terminal:
Required app not running[REQUIRED] socket-proxy must be installed and running first- Deployrr Dashboard. See Set up and maintain the Deployrr Dashboard.
- Portainer
- Dozzle and Dozzle Agent
- Homepage, Homarr, Homer, Dashy and Flame
- Glances
- Dockwatch, Dockpeek, Dockhand and DweebUI
- DeUnhealth
- Docker Garbage Collection
Install Socket Proxy, then start the install again.
Apps that do not need it
Section titled “Apps that do not need it”Uptime Kuma and What’s Up Docker (WUD) do not require Socket Proxy to install. They still join its network.
When Socket Proxy is not running
Section titled “When Socket Proxy is not running”Signs that Socket Proxy is down:
- The Docker menu shows
STOPPEDon the Socket Proxy line. - A box says
Socket Proxy - Must be running (Docker menu). - The terminal says
socket-proxy must be installed and running first. - Traefik, Portainer, Dozzle or another app can’t see your containers.
Start it
Section titled “Start it”Stack Manager needs a Basic, Plus or Pro license.
- Choose Tools > Stack Manager > Start Container. See Stack Manager.
- At
Select an app to start:, type the number ofsocket-proxyand press Enter. The list also offersallandexit. If it saysNo exited containers found., Socket Proxy is not stopped. - Look for
socket-proxy started.
If it does not stay up, use Recreate in the same menu. Pick socket-proxy from the list. Or run Docker > Socket Proxy again and choose Yes in the Already Installed box.
Read its logs
Section titled “Read its logs”With the Deployrr bash aliases: dlogs socket-proxy. Press Ctrl+C to stop following.
Without the aliases:
sudo docker logs --tail 50 -f socket-proxyCheck the state of your containers
Section titled “Check the state of your containers”With the Deployrr bash aliases: dpss. Without them:
sudo docker ps -aLook for socket-proxy and its status.
Restart the apps that use it
Section titled “Restart the apps that use it”After Socket Proxy is back, an app that lost contact may still show an error. Use Tools > Stack Manager > Recreate on that app. Pick it from the list.
If Traefik is the app, see Read the Traefik logs.
Where its files are
Section titled “Where its files are”Deployrr keeps the Socket Proxy compose file in the compose/HOSTNAME folder inside your Docker folder. HOSTNAME is your server’s hostname. The file is named socket-proxy.yml.
You do not need to edit it. Stack Manager can start, stop and recreate it.
Next steps
Section titled “Next steps”- Set up Traefik with Set up Traefik.
- Install the Deployrr Dashboard. The Docker menu shows it right under Socket Proxy.

