• Stars
    star
    687
  • Rank 65,799 (Top 2 %)
  • Language HCL
  • License
    Apache License 2.0
  • Created almost 5 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

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.

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.

  • 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.

Cloud Deployments

Choosing a cloud provider? Watch this 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.

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