# notthebee/ansible-easy-vpn

An Ansible playbook that sets up a Wireguard server with ad blocking, DNS-over-HTTPS, and a WebUI with 2FA

Repository: https://github.com/notthebee/ansible-easy-vpn
Canonical: https://ross.abutalabs.com/products/ansible-easy-vpn
Language: Shell
License: NOASSERTION
License Family: other
Topics: 2fa, ansible, authelia, ubuntu, vpn, wireguard, adguard
Archived: true
Last push: 2024-11-09T10:56:05+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 1534, "days_push": 662, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: archived, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1082, forks 253 (observed 2026-08-28T04:03:31.033432+00:00)

## What it is
An Ansible playbook that provisions a single-purpose VPS into a WireGuard VPN server with AdGuard ad blocking, DNS-over-HTTPS, and a 2FA-protected web UI via Authelia. The project has been archived by its author and is no longer maintained.

## Use cases
- set up a personal wireguard vpn server on a vps
- block ads network-wide with adguard and dns-over-https
- protect a self-hosted web ui with two-factor authentication
- harden ssh and automate updates on a fresh cloud server
- deploy a turnkey vpn with docker containers via ansible

## When to choose
- you want a one-command wireguard + adblock setup on a compatible ubuntu vps
- you are comfortable forking and maintaining the playbook yourself since it is archived

## When to avoid
- you need maintained, supported software
- your vps is not a fresh single-purpose server
- you want to run other services on the same machine
- you are not comfortable debugging ansible and docker issues yourself

## Facets
- artifact type: infra-config
- maturity: abandoned
- function: vpn, infrastructure-as-code, deployment, security, caching, auth
- domain: networking, privacy, self-hosted, security, censorship-circumvention
- platform: self-hosted
- tags: wireguard, ansible-playbook, adguard, authelia, dns-over-https, two-factor-authentication, vps-setup, archived, devops, linux, ubuntu, docker

## Member repositories
- notthebee/ansible-easy-vpn (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:31.033432+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:51:17.113700+00:00, confidence not recorded.
  - readme: https://github.com/notthebee/ansible-easy-vpn (fetched 2026-08-28T04:03:31.033432+00:00, sha 10978f3f4696)
- Data as of 2026-08-30T08:39:29.467469+00:00.