Enable Static Config Editor

How to enable the static config editor for an existing Traefik Manager install without re-running the setup script.

Prerequisites: the path to your traefik.yml on the host, and a choice of restart method.

---

Generate it

Paste your compose file, pick a restart method, give it the host path to traefik.yml, and copy the result. This does Steps 1 to 3 for you.

Your current compose

Restart methodSocket proxy (recommended)Poison pillDirect socket

Enable Static Config editor

Then apply it:

docker compose pull
docker compose up -d

Prefer to do it by hand, or not using Compose? The steps below cover Docker, Podman and systemd.

---

Step 1 - Mount traefik.yml into TM

Add the volume to your Traefik Manager service. The mount must be read-write (no :ro).

services:
  traefik-manager:
    volumes:
      - /path/to/traefik/traefik.yml:/app/traefik.yml

---

Step 2 - Set env vars on TM

services:
  traefik-manager:
    environment:
      - STATIC_CONFIG_PATH=/app/traefik.yml
      - RESTART_METHOD=proxy        # proxy | socket | poison-pill
      - TRAEFIK_CONTAINER=traefik   # proxy and socket only

---

Step 3 - Configure your restart method

Pick one tab below and follow only that section.

Add the socket-proxy service and set DOCKER_HOST on TM. A docker-compose.override.yml keeps your main file untouched:

# docker-compose.override.yml
services:
  traefik-manager:
    environment:
      - STATIC_CONFIG_PATH=/app/traefik.yml
      - RESTART_METHOD=proxy
      - TRAEFIK_CONTAINER=traefik
      - DOCKER_HOST=tcp://socket-proxy:2375
    networks:
      - socket-proxy-net

  socket-proxy:
    image: tecnativa/docker-socket-proxy
    restart: unless-stopped
    environment:
      CONTAINERS: 1
      POST: 1
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    networks:
      - socket-proxy-net

networks:
  socket-proxy-net:
    internal: true

Docker Compose merges this with your existing docker-compose.yml on every up.

To undo: rm docker-compose.override.yml && docker compose up -d

:::

---

Step 4 - Apply

docker compose up -d

Or to recreate only TM without restarting Traefik:

docker compose up -d --force-recreate traefik-manager

---

Verify

Open Traefik Manager - a Static Config row appears under Settings → Interface with three choices:

Choice	Where it appears
Off	Nowhere.
Settings	As a Static Config panel in the Settings sidebar.
Tab	As its own tab in the side navigation.

If the row does not appear, check that a static config path is set - either STATIC_CONFIG_PATH or the field under Settings → System Monitoring → File Paths, which wins when both are present - and that the file exists at that path inside the container:

docker exec traefik-manager ls -la /app/traefik.yml

---

Undo

Remove the volume mount, env vars, and any compose additions you added, then restart TM:

docker compose up -d --force-recreate traefik-manager

Static Config disappears. Your traefik.yml is unchanged.