{
  "slug": "pihole-swarm",
  "kind": "swarm",
  "metadata": {
    "name": "Pihole",
    "description": "Network-wide DNS-based ad and tracker blocker that acts as a DNS sinkhole. Filters content at the DNS level for all devices on your network.",
    "tags": [
      "traefik",
      "network",
      "volume"
    ],
    "icon": {
      "provider": "selfhst",
      "id": "pi-hole"
    },
    "draft": false,
    "version": {
      "name": "2026.04.1",
      "source_dep_name": "docker.io/pihole/pihole",
      "source_dep_version": "2026.04.1"
    }
  },
  "variables": [
    {
      "title": "General",
      "name": "general",
      "items": [
        {
          "name": "service_name",
          "type": "str",
          "title": "Service Name",
          "required": false,
          "default": "pihole",
          "config": {
            "placeholder": "pihole"
          }
        },
        {
          "name": "container_hostname",
          "type": "str",
          "title": "Container Hostname",
          "required": false
        },
        {
          "name": "container_timezone",
          "type": "str",
          "title": "Container Timezone",
          "required": true,
          "config": {
            "placeholder": "Europe/Berlin"
          }
        },
        {
          "name": "user_uid",
          "type": "int",
          "title": "User Uid",
          "required": false,
          "default": 1000,
          "config": {
            "placeholder": "1000"
          }
        },
        {
          "name": "user_gid",
          "type": "int",
          "title": "User Gid",
          "required": false,
          "default": 1000,
          "config": {
            "placeholder": "1000"
          }
        }
      ]
    },
    {
      "title": "Admin Settings",
      "name": "admin-settings",
      "items": [
        {
          "name": "webpassword",
          "type": "secret",
          "title": "Admin Password",
          "required": false,
          "config": {
            "autogenerated": {
              "length": 32
            }
          }
        }
      ]
    },
    {
      "title": "Ports",
      "name": "ports",
      "items": [
        {
          "name": "ports_dns",
          "type": "int",
          "title": "DNS Port",
          "required": true,
          "default": 53,
          "config": {
            "placeholder": "53"
          }
        },
        {
          "name": "ports_http",
          "type": "int",
          "title": "HTTP Port",
          "required": false,
          "default": 80,
          "config": {
            "placeholder": "80"
          }
        },
        {
          "name": "ports_https",
          "type": "int",
          "title": "HTTPS Port",
          "required": false,
          "default": 443,
          "config": {
            "placeholder": "443"
          }
        },
        {
          "name": "ports_ntp",
          "type": "int",
          "title": "External NTP port",
          "required": true,
          "default": 123,
          "config": {
            "placeholder": "123"
          }
        }
      ]
    },
    {
      "title": "Traefik",
      "name": "traefik",
      "toggle": "traefik_enabled",
      "items": [
        {
          "name": "traefik_host",
          "type": "str",
          "title": "Host",
          "required": true,
          "config": {
            "placeholder": "pihole"
          }
        },
        {
          "name": "traefik_network",
          "type": "str",
          "title": "Network",
          "required": true,
          "default": "traefik",
          "config": {
            "placeholder": "traefik"
          }
        },
        {
          "name": "traefik_domain",
          "type": "str",
          "title": "Domain",
          "required": true,
          "config": {
            "placeholder": "home.arpa"
          }
        },
        {
          "name": "traefik_enabled",
          "type": "bool",
          "title": "Traefik",
          "required": false,
          "default": false
        },
        {
          "name": "traefik_entrypoint",
          "type": "str",
          "title": "Traefik Entrypoint",
          "required": false,
          "default": "web",
          "config": {
            "placeholder": "web"
          },
          "needs": [
            "traefik_enabled=true"
          ]
        }
      ]
    },
    {
      "title": "Traefik TLS",
      "name": "traefik-tls",
      "toggle": "traefik_tls_enabled",
      "items": [
        {
          "name": "traefik_tls_certresolver",
          "type": "str",
          "title": "Cert Resolver",
          "required": true,
          "default": "cloudflare",
          "config": {
            "placeholder": "cloudflare"
          }
        },
        {
          "name": "traefik_tls_enabled",
          "type": "bool",
          "title": "TLS",
          "required": false,
          "default": false
        },
        {
          "name": "traefik_tls_entrypoint",
          "type": "str",
          "title": "Traefik Tls Entrypoint",
          "required": false,
          "default": "websecure",
          "config": {
            "placeholder": "websecure"
          },
          "needs": [
            "traefik_tls_enabled=true"
          ]
        }
      ]
    },
    {
      "title": "Network",
      "name": "network",
      "items": [
        {
          "name": "network_mode",
          "type": "enum",
          "title": "Network Mode",
          "required": false,
          "default": "bridge",
          "config": {
            "options": [
              "bridge",
              "host",
              "macvlan"
            ]
          }
        },
        {
          "name": "network_name",
          "type": "str",
          "title": "Network Name",
          "required": false,
          "default": "pihole_network",
          "config": {
            "placeholder": "pihole_network"
          }
        },
        {
          "name": "network_macvlan_ipv4_address",
          "type": "str",
          "title": "IPv4 Address",
          "required": true,
          "default": "IP_ADDRESS",
          "needs": [
            "network_mode=macvlan"
          ],
          "config": {
            "placeholder": "IP_ADDRESS"
          }
        },
        {
          "name": "network_macvlan_parent_interface",
          "type": "str",
          "title": "Parent Interface",
          "required": true,
          "default": "eth0",
          "needs": [
            "network_mode=macvlan"
          ],
          "config": {
            "placeholder": "eth0"
          }
        },
        {
          "name": "network_macvlan_subnet",
          "type": "str",
          "title": "Subnet",
          "required": true,
          "default": "IP_RANGE",
          "needs": [
            "network_mode=macvlan"
          ],
          "config": {
            "placeholder": "IP_RANGE"
          }
        },
        {
          "name": "network_macvlan_gateway",
          "type": "str",
          "title": "Gateway",
          "required": true,
          "default": "GATEWAY",
          "needs": [
            "network_mode=macvlan"
          ],
          "config": {
            "placeholder": "GATEWAY"
          }
        },
        {
          "name": "network_external",
          "type": "bool",
          "title": "External Network",
          "required": false,
          "default": false
        }
      ]
    },
    {
      "title": "Docker Swarm",
      "name": "swarm",
      "items": [
        {
          "name": "swarm_placement_host",
          "type": "str",
          "title": "Swarm Placement Host",
          "required": true,
          "config": {
            "placeholder": "swarm-node-1"
          }
        }
      ]
    },
    {
      "title": "Volume",
      "name": "volume",
      "items": [
        {
          "name": "volume_mode",
          "type": "enum",
          "title": "Volume Mode",
          "required": true,
          "default": "local",
          "config": {
            "options": [
              "local",
              "mount",
              "nfs"
            ]
          }
        },
        {
          "name": "volume_mount_path",
          "type": "str",
          "title": "Volume Mount Path",
          "required": true,
          "default": "/data",
          "needs": [
            "volume_mode=mount"
          ],
          "config": {
            "placeholder": "/data"
          }
        },
        {
          "name": "volume_nfs_server",
          "type": "str",
          "title": "Volume Nfs Server",
          "required": true,
          "default": "NFS_SERVER",
          "needs": [
            "volume_mode=nfs"
          ],
          "config": {
            "placeholder": "NFS_SERVER"
          }
        },
        {
          "name": "volume_nfs_path",
          "type": "str",
          "title": "Volume Nfs Path",
          "required": true,
          "default": "/export",
          "needs": [
            "volume_mode=nfs"
          ],
          "config": {
            "placeholder": "/export"
          }
        },
        {
          "name": "volume_nfs_options",
          "type": "str",
          "title": "Volume Nfs Options",
          "required": true,
          "default": "rw,nolock,soft",
          "needs": [
            "volume_mode=nfs"
          ],
          "config": {
            "placeholder": "rw,nolock,soft"
          }
        }
      ]
    }
  ]
}