Overview

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:

Instructions

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/)

Videos

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

Standalone Raspberry Pi or Ubuntu Server

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

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

Cloud Deployments

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.

Discussion

Discord Room

Changelog

2022-10

• 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