Environment Variables

lancache-dns’s behaviour is controlled by a variety of environment variables. They are detailed here along with the default values.

Changing Environment Variables

Recreating is ok

Changing environment variables in docker requires you to delete and recreate your containers. Don't worry, your cache data is safely stored OUTSIDE in a volume and will be reused by the new containers

If you are using docker-compose these variables can be changed by editing the .env file provided. If a specific variable does not exist in your version of the .env just add a new line.

If you are using docker from the command line environment variables are specified using -e VARIABLE=VALUE format when you launch the container.

General Settings

Variable Description

CACHE_DOMAINS_REPO

The github repo url for the cache_domains files to use to populate the cdn maps, if you do not want to use the recommended source for testing purposes.

Default:  https://github.com/uklans/cache-domains.git

CACHE_DOMAINS_BRANCH

The branch of the CACHE_DOMAINS_REPO to use

Default:  master

UPSTREAM_DNS

The upstream DNS server(s) the cache should use. The defaults are Google DNS. Multiple upstream dns servers are allowed, separated by semi colons (or spaces). Do NOT point this at lancache-dns.

Default:  8.8.8.8

Advanced Settings

HERE BE DRAGONS!!!

These settings really aren't meant to be changed very often, it is highly unlikely you want to change them unless it's been recommended by a team member or you REALLY know what you are doing

Variable Description

STEAMCACHE_DNS_VERSION

Internal reference version. DO NOT CHANGE THIS.

Default:  1

ENABLE_DNSSEC_VALIDATION

Default:  false

LANCACHE_DNSDOMAIN

Internally used top level domain within the DNS RPZ structure for CNAMES. Should be largely invisible to end users.

Default:  cache.lancache.net