Skip to content

Upgrading from v5.x

Info

The last image of the Pi-hole docker container which contained v5.x Pi-hole components was 2024.07.0

Versions after this will be based on v6.x Pi-hole components.

Changed Environment Variables

Nearly all environment variables from previous versions have been removed, but functionality can be replicated by setting their FTLCONF_ equivalent instead. (See Configuration page for more details)

Misc

Old Variable New Variable
CUSTOM_CACHE_SIZE FTLCONF_dns_cache_size
DNS_BOGUS_PRIV FTLCONF_dns_bogusPriv
DNS_FQDN_REQUIRED FTLCONF_dns_domainNeeded
DNSMASQ_LISTENING FTLCONF_dns_listeningMode
DNSSEC FTLCONF_dns_dnssec
INTERFACE FTLCONF_dns_interface
PIHOLE_DNS_ FTLCONF_dns_upstreams
QUERY_LOGGING FTLCONF_dns_queryLogging
WEBPASSWORD FTLCONF_webserver_api_password
WEB_PORT FTLCONF_webserver_port
WEBTHEME FTLCONF_webserver_interface_theme
WEBUIBOXEDLAYOUT FTLCONF_webserver_interface_boxed

DHCP Variables

Old New
DHCP_ACTIVE FTLCONF_dhcp_active
DHCP_START FTLCONF_dhcp_start
DHCP_END FTLCONF_dhcp_end
DHCP_ROUTER FTLCONF_dhcp_router
DHCP_LEASETIME FTLCONF_dhcp_leaseTime
PIHOLE_DOMAIN FTLCONF_dns_domain
DHCP_IPv6 FTLCONF_dhcp_ipv6
DHCP_rapid_commit FTLCONF_dhcp_rapidCommit

Conditional Forwarding Variables

Reverse server (REV_SERVER*) variables should be replaced with the single FTLCONF_dns_revServers, which accepts an array of reverse servers (delimited by ;) in the following format:

<enabled>,<ip-address>[/<prefix-len>],<server>[#<port>],<domain>

If, for example, you had the following old style variables:

  • REV_SERVER: 'true'
  • REV_SERVER_DOMAIN: 'lan'
  • REV_SERVER_TARGET: '192.168.0.1#53'
  • REV_SERVER_CIDR: '192.168.0.0/24'

You would now set:

FTLCONF_dns_revServers: 'true,192.168.0.0/24,192.168.0.1#53,lan'

Removed Variables

The following variables can be removed without replacement, as they are no longer used:

  • CONDITIONAL_FORWARDING
  • CONDITIONAL_FORWARDING_DOMAIN
  • CONDITIONAL_FORWARDING_IP
  • CONDITIONAL_FORWARDING_REVERSE
  • CORS_HOSTS
  • DNS1
  • DNS2
  • FTLCONF_REPLY_ADDR4
  • FTLCONF_REPLY_ADDR6
  • IPV6
  • ServerIP
  • ServerIPv6
  • SKIPGRAVITYONBOOT
  • TEMPERATUREUNIT
  • VIRTUAL_HOST
  • WEB_BIND_ADDR
  • WEB_GID
  • WEB_UID
  • WEBLOGS_STDOUT
  • WEBPASSWORD_FILE