https://github.com/AnarchoTechNYC/ansible-role-dnscrypt-proxy

:lock::postal_horn: Spin up a(n optionally Torified) DNS, DNSCrypt v2, DNS-over-TLS, and/or DNS-over-HTTPS proxy server.
https://github.com/AnarchoTechNYC/ansible-role-dnscrypt-proxy

ansible-role dnscrypt

Last synced: 3 months ago
JSON representation

:lock::postal_horn: Spin up a(n optionally Torified) DNS, DNSCrypt v2, DNS-over-TLS, and/or DNS-over-HTTPS proxy server.

• Host: GitHub
• URL: https://github.com/AnarchoTechNYC/ansible-role-dnscrypt-proxy
• Owner: AnarchoTechNYC
• Created: 2020-03-21T20:40:13.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2023-03-14T06:47:10.000Z (almost 2 years ago)
• Last Synced: 2024-08-02T15:55:23.602Z (6 months ago)
• Topics: ansible-role, dnscrypt
• Homepage:
• Size: 5.86 KB
• Stars: 4
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Anarcho-Tech NYC: dnscrypt-proxy [![Build Status](https://travis-ci.org/AnarchoTechNYC/ansible-role-dnscrypt-proxy.svg?branch=master)](https://travis-ci.org/AnarchoTechNYC/ansible-role-dnscrypt-proxy)

An [Ansible role](https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html) for installing a [dnscrypt-proxy](https://github.com/DNSCrypt/dnscrypt-proxy) server. Notably, this role has been tested with [Raspbian](https://www.raspbian.org/) on [Raspberry Pi](https://www.raspberrypi.org/) hardware. This role's purpose is to make it simple to install and run a `dnscrypt-proxy` instance, either locally or as a server, with minimal resources.

## Role variables

* `dnscrypt_proxy_version` - Version of `dnscrypt-proxy` as released from [the `DNSCrypt/dnscrypt-proxy` repository](https://github.com/DNSCrypt/dnscrypt-proxy/releases) to download and use.

* `dnscrypt_proxy_install_prefix` - Absolute filesystem path prefix in which to install `dnscrypt-proxy`. Default: `/opt/local`.

* `dnscrypt_proxy_listen_address` - Address on which to offer `dnscrypt-proxy`'s services. The package default is `127.0.0.1:53`, but this role's default is `:53` (port 53 on all interfaces).

See the [`defaults/main.yaml`](defaults/main.yaml) file for a more thorough example.

# Testing

Use [Molecule](https://molecule.readthedocs.io/en/latest/) to run the tests. (You'll also need to install [Docker](https://docker.com/), as tests are run in Docker containers.) Here's how to install Molecule into a virtual environment.

```sh

# Molecule is written in Python, so you'll also need Python.

python -m venv venv                      # Create your virtual environment.

source venv/bin/activate                 # Activate it.

pip install molecule ansible-lint docker # Install testing tools.

# Then, you can run the tests:

molecule test

# When you're done, deactivate your virtual environment.

deactivate

```