Install Lancache on Debian 10

Step 1: Installing Docker

The Docker installation package available in the official Debian repository may not be the latest version. To ensure we get the latest version, we’ll install Docker from the official Docker repository. To do that, we’ll add a new package source, add the GPG key from Docker to ensure the downloads are valid, and then install the package.

First, update your existing list of packages:

sudo apt update

Next, install a few prerequisite packages which let apt use packages over HTTPS:

sudo apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common

Then add the GPG key for the official Docker repository to your system:

curl -fsSL | sudo apt-key add -

Add the Docker repository to APT sources:

sudo add-apt-repository "deb [arch=amd64] $(lsb_release -cs) stable"

Next, update the package database with the Docker packages from the newly added repo:

sudo apt update

Make sure you are about to install from the Docker repo instead of the default Debian repo:

apt-cache policy docker-ce

You’ll see output like this, although the version number for Docker may be different:

Output of apt-cache policy docker-ce
Installed: (none)
Candidate: 5:18.09.7~3-0~debian-buster
Version table:
5:18.09.7~3-0~debian-buster 500
500 buster/stable amd64 Packages

Notice that docker-ce is not installed, but the candidate for installation is from the Docker repository for Debian 10 (buster).

Finally, install Docker:

sudo apt install docker-ce

Docker is now installed, the daemon started, and the process enabled to start on boot. Check that it’s running:

sudo systemctl status docker

The output will be similar to the following, showing that the service is active and running:

● docker.service - Docker Application Container Engine
Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2019-07-08 15:11:19 UTC; 58s ago
Main PID: 5709 (dockerd)
Tasks: 8
Memory: 31.6M
CGroup: /system.slice/docker.service
└─5709 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

Sep-2 Installing Lancache

git clone lancache
cd lancache
nano .env
docker-compose up -d


  • Configure your router to serve ONLY lancache-dns
  • LANCACHE_IP should be set to the ip address that you wish your DNS to hand out for your cache container. In normal operation this would be the ip of the box running your cache.
  • DNS_BIND_IP can be commented out in a simple setup or you can choose the ip address of your dns container (which could be the same as your lancache ip)
  • CACHE_ROOT is where you want to store the cached data. For best practice we recommend a mount point on a separate volume from your OS.
  • CACHE_DISK_SIZE ensure this matches the size of the volume you have the cache root on. Remember to leave some space availaible. (For very large sizes you should understand what CACHE_MEM_SIZE does)

Test your installation by updating your PC DNS IP to Lancache Server IP. There’s a web-based tool from the developer to check you cache status too-

Step-3: PC Instructions on how to use:

  • Click on Network and Internet.
  • Click on Network and Sharing Center.
  • Click the Change Adapter Settings option in the left pane.
  • interface connected to the internet, and select the Properties option.
  • Select the Internet Protocol Version 4 (TCP/IPv4) option.
  • Click the Properties button.
  • Click the Use the following DNS server Addresses option.
  • Type “X.X.X.X” for the “preferred” DNS address. This should be the only Lancache DNS server listed.
  • Click the OK button.
  • Click the Close button.

You’re done.



Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.