Traefik
| Description / name | Input element |
|---|---|
| Container Registry | |
| Container Configuration Root Path | |
| Timezone | |
| User ID | |
| Group ID | |
| Traefik Host Port | |
| Traefik /config Path |
Modern HTTP reverse proxy and load balancer on FreeBSD.
| Port | 80 |
| Registry | ghcr.io/daemonless/traefik |
| Daemonless | daemonless/traefik |
| Source | traefik/traefik |
| Website | traefik.io |
Version Tags
| Tag | Description | Best For |
|---|---|---|
latest |
Upstream Binary. Built from official release. | Most users. Matches Linux Docker behavior. |
pkg |
FreeBSD Quarterly. Uses stable, tested packages. | Production stability. |
pkg-latest |
FreeBSD Latest. Rolling package updates. | Newest FreeBSD packages. |
Root Privileges Required
Podman on FreeBSD currently requires root. All commands must be run as root (or via doas/sudo).
Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions.
Deployment
services:
traefik:
image: "ghcr.io/daemonless/traefik:latest"
container_name: traefik
environment:
- PUID=1000 # User ID for the application process
- PGID=1000 # Group ID for the application process
- TZ=UTC # Timezone for the container
volumes:
- "/path/to/containers/traefik:/config"
ports:
- "80:80"
- "443:443"
- "8080:8080"
restart: unless-stopped
options:
- virtualnet: ':<random> default'
- nat:
services:
traefik:
name: traefik
options:
- container: 'boot args:--pull'
oci:
user: root
environment:
- PUID: !ENV '${PUID}'
- PGID: !ENV '${PGID}'
- TZ: !ENV '${TZ}'
volumes:
- TRAEFIK_CONFIG_PATH: /config
volumes:
TRAEFIK_CONFIG_PATH:
device: '/path/to/containers/traefik'
Interactive Configuration
Parameters
Environment Variables
| Variable | Default | Description |
|---|---|---|
PUID |
1000 |
User ID for the application process |
PGID |
1000 |
Group ID for the application process |
TZ |
UTC |
Timezone for the container |
Volumes
| Path | Description |
|---|---|
/config |
Configuration directory (traefik.yml, dynamic/, letsencrypt/) |
Ports
| Port | Protocol | Description |
|---|---|---|
80 |
TCP | HTTP |
443 |
TCP | HTTPS |
8080 |
TCP | Dashboard/API |
Implementation Details
- Architectures: amd64
- User:
bsd(UID/GID set via PUID/PGID). Defaults to1000:1000. - Base: Built on
ghcr.io/daemonless/base(FreeBSD 15.0).
Need help? Join our Discord community.