terraform-docker-pi-hole

This repository deploys a PiHole setup to docker

Docs

Requirements

Name	Version
terraform	>=1.0.9
docker	2.15.0

Providers

Name	Version
docker	2.15.0

Modules

No modules.

Resources

Name	Type
docker_container.pi_hole	resource
docker_image.pi_hole_image	resource
docker_network.pi_hole_network	resource
docker_volume.pi_hole_volume	resource
docker_registry_image.pi_hole	data source

Inputs

Name	Description	Type	Default	Required
advanced_variables	Any advanced variables described here https://github.com/pi-hole/docker-pi-hole/#advanced-variables	list(string)	n/a	yes
dhcp_interface_bind	The network interface that the dhcp port will bind to	string	"0.0.0.0"	no
dhcp_port	The host port number the internal port 67 (DHCP) will map to	number	67	no
dns_interface_bind	The network interface that the dns port will bind to	string	"0.0.0.0"	no
dns_port	The host port number the internal port 53 (DNS) will map to	number	53	no
docker_host	The host where docker resides	string	n/a	yes
http_interface_bind	The network interface that the http port will bind to	string	"0.0.0.0"	no
http_port	The host port number the internal port 80 (http) will map to	number	80	no
https_interface_bind	The network interface that the https port will bind to	string	"0.0.0.0"	no
https_port	The host port number the internal port 443 (https) will map to	number	443	no
local_timezone	Your timezone to make sure logs rotate at local midnight instead of at UTC midnight	string	n/a	yes
optional_variables	Any optional variables described here https://github.com/pi-hole/docker-pi-hole/#optional-variables	list(string)	n/a	yes
pi_hole_container_name	The name of the Pi Hole container to be created	string	n/a	yes
pi_hole_image_name	The name of the Pi Hole docker image that should be pulled	string	n/a	yes
pi_hole_network_name	The name of the docker network that the Pi Hole container will be connected to	string	n/a	yes
pi_hole_volume_name	The name of the docker volume to be used by the Pi Hole container	string	n/a	yes
server_ip	Set to your server's LAN IP, used by web block modes and lighttpd bind address	string	"0.0.0.0"	no
web_password	Admin password. Run docker logs pihole grep random to find your random pass. To update this variable you need to destroy the current container and redeploy	string	n/a	yes

Outputs

Name	Description
pi_hole_container_entrypoint	List of the entrypoints for the deployed container
pi_hole_container_hostname	The hostname assigned to the container after deploy
pi_hole_container_id	The id of the deployed container
pi_hole_container_ip	The ip address of the deployed container
pi_hole_container_networks	The networks associated with the deployed container

License

This code is open sourced licensed under the Apache 2.0 License