chadgeary / cloudblock

Cloudblock deploys secure ad-blocking and VPN for all devices. Text and video guides included! 6 supported cloud providers, plus Ubuntu and Raspberry Pi. Cloudblock deploys Wireguard VPN, Pi-Hole DNS Ad-blocking, and DNS over HTTPS in a cloud provider - or locally - using Terraform and Ansible.
Apache License 2.0
811 stars 79 forks source link
adblock adblocker ansible aws cloud dns gcp oci oracle-cloud-infrastructure pi-hole pihole privacy scaleway terraform vpn wireguard

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:

Diagram

Instructions

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

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.

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.

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

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