Traefik Manager

Appearance

SupportStar

Enable Static Config Editor ​

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

Prerequisites: path to your traefik.yml on the host, and a decision on which restart method you want to use.

Step 1 - Mount traefik.yml into TM ​

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

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

Step 2 - Set env vars on TM ​

yaml
services:
  traefik-manager:
    environment:
      - STATIC_CONFIG_PATH=/app/traefik.yml
      - RESTART_METHOD=proxy        # proxy | socket | poison-pill
      - TRAEFIK_CONTAINER=traefik   # your Traefik container name

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. You can do this with a docker-compose.override.yml to avoid touching your main file:

yaml
# 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 automatically on every up.

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

:::

Step 4 - Apply ​

bash
docker compose up -d

Or to recreate only TM without restarting Traefik:

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

Verify ​

Open Traefik Manager - the Static Config editor should appear under Settings. If it does not appear, check that STATIC_CONFIG_PATH is set and the file exists at that path inside the container:

bash
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:

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

The Static Config editor will disappear from Settings. Your traefik.yml is unchanged.