TrafegoDNS

Overview

TrafegoDNS automatically manages DNS records based on container configuration. It supports both Traefik integration and direct Docker container label mode, making it compatible with any web server or reverse proxy solution. Key Features: - Supports multiple DNS providers (Cloudflare, DigitalOcean, Route53) - Two operation modes: Traefik API integration or direct Docker labels - Optional cleanup of orphaned DNS records - Real-time monitoring of Docker container events - Please refer to the readme before deploying this container: https://github.com/elmerfds/TrafegoDNS

Runtime arguments

Network: bridge
Shell: bash
Privileged: false

Template configuration

Operation ModeVariable

Choose how to detect hostnames: Traefik API or direct container labels

Target: OPERATION_MODE
Default: traefik|direct

DNS ProviderVariable

Select DNS provider to use

Target: DNS_PROVIDER
Default: cloudflare|digitalocean|route53

Cloudflare TokenVariable

Cloudflare API token (requires DNS edit permissions) - Required when using Cloudflare provider

Target: CLOUDFLARE_TOKEN

Cloudflare ZoneVariable

Your domain name managed in Cloudflare (e.g., example.com) - Required when using Cloudflare provider

Target: CLOUDFLARE_ZONE

DigitalOcean TokenVariable

DigitalOcean API token (requires write access) - Required when using DigitalOcean provider

Target: DO_TOKEN

DigitalOcean DomainVariable

Your domain name managed in DigitalOcean (e.g., example.com) - Required when using DigitalOcean provider

Target: DO_DOMAIN

Route53 Access KeyVariable

AWS IAM access key with Route53 permissions - Required when using Route53 provider

Target: ROUTE53_ACCESS_KEY

Route53 Secret KeyVariable

AWS IAM secret key - Required when using Route53 provider

Target: ROUTE53_SECRET_KEY

Route53 ZoneVariable

Your domain name managed in Route53 (e.g., example.com) - Required when using Route53 provider

Target: ROUTE53_ZONE

Traefik API URLVariable

URL to Traefik API (including protocol and port) - Only used when Operation Mode is 'traefik'

Target: TRAEFIK_API_URL
Default: http://traefik:8080/api
Value: http://traefik:8080/api

Cleanup OrphanedVariable

Whether to automatically remove orphaned DNS records

Target: CLEANUP_ORPHANED
Default: true|false
Value: false

Config PathPathrw

Configuration storage path

Target: /config
Default: /mnt/user/appdata/trafegodns
Value: /mnt/user/appdata/trafegodns

Docker SocketPathro

Docker socket for container monitoring

Target: /var/run/docker.sock
Default: /var/run/docker.sock
Value: /var/run/docker.sock

PUIDVariable

User ID to run as

Default: 99
Value: 99

PGIDVariable

Group ID to run as

Default: 100
Value: 100

Log LevelVariable

Logging level

Target: LOG_LEVEL
Default: ERROR|WARN|INFO|DEBUG|TRACE
Value: INFO

Preserved HostnamesVariable

Comma-separated list of hostnames to preserve from cleanup (supports wildcards)

Target: PRESERVED_HOSTNAMES

Managed HostnamesVariable

Comma-separated list of hostnames to create and maintain (format: hostname:type:content:ttl:proxied)

Target: MANAGED_HOSTNAMES

Traefik API UsernameVariable

Optional basic auth username for Traefik API - Only used when Operation Mode is 'traefik'

Target: TRAEFIK_API_USERNAME

Traefik API PasswordVariable

Optional basic auth password for Traefik API - Only used when Operation Mode is 'traefik'

Target: TRAEFIK_API_PASSWORD

Route53 Zone IDVariable

Alternative to ROUTE53_ZONE: Your Route53 hosted zone ID - Only used when DNS Provider is 'route53'

Target: ROUTE53_ZONE_ID

Route53 RegionVariable

AWS region for Route53 API calls - Only used when DNS Provider is 'route53'

Target: ROUTE53_REGION
Default: eu-west-2
Value: eu-west-2

Links

Template Support Registry Project

Details

Repository

ghcr.io/elmerfds/trafegodns:latest

Registry

https://github.com/elmerfds/TrafegoDNS

Last Updated2026-05-31

First Seen2025-03-24

Run TrafegoDNS on Unraid.

TrafegoDNS is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS