End-to-end DNS encryption with DNS-based ad-blocking, built in the cloud automatically using Terraform with Ansible. Choose your cloud provider or a standalone installation.

Combines wireguard (DNS VPN), pihole (adblock), and cloudflared (DNS over HTTPS) docker containers, as visualized:

Several deployment options are available, see the README of each subdirectory for platform-specific guides.

• AWS (Amazon)
• Azure (Microsoft)
• DO (Digital Ocean)
• GCP (Google)
• Lightsail (Fixed-rate/Low-cost AWS)
• OCI (Oracle)
• SCW (Scaleway)
• Standalone Raspberry Pi or Ubuntu Server (under playbooks/)

As these videos have aged a bit, replace references to Ubuntu 18.04 with Ubuntu 22.04. Text guides are up to date.

Step-by-step, follow along with me as I install on a Raspberry Pi.

• Raspberry Pi 4+ (Raspbian 10/Buster) -- video - guide

Choosing a cloud provider? Watch this video for a mostly un-biased comparison of free options/free trials.

Step-by-step, follow along with me as I deploy from a windows desktop - for Cloud deployments.

• All cloud deployments should watch this prerequisites video first.

After watching the cloud prerequisites video, follow a guide specific to your cloud provider.

• Amazon Web Services (AWS / Lightsail) - (video - readme)
• Microsoft Azure (AZW) - (video - readme)
• Digital Ocean (DO) - (video - readme)
• Google Cloud Platform (GCP) - (video - readme)
• Oracle Cloud Infrastructure (OCI) - (video - readme)
• Scaleway Cloud (SCW) (video - readme)

For maintaining the containers running your cloudblock services, see the README (or terraform output) specific to your deployment. For Cloud deployments, this video describes maintenance steps.

Discord Room

• Added references to Ubuntu 22.04 (replacing Ubuntu 18.04) for:
  • WSL installation
  • Cloud virtual machine images
• Note about Oracle's private key generation for oci config