https://github.com/sbarbett/uddr_linux_bootstrap
A shell script for configuring systemd to use Vercara's UltraDDR product for DNS resolution
https://github.com/sbarbett/uddr_linux_bootstrap
dns-over-https dnscrypt-proxy protective-dns systemd ultraddr
Last synced: 3 months ago
JSON representation
A shell script for configuring systemd to use Vercara's UltraDDR product for DNS resolution
- Host: GitHub
- URL: https://github.com/sbarbett/uddr_linux_bootstrap
- Owner: sbarbett
- License: mit
- Created: 2024-03-28T01:44:01.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-09T15:05:51.000Z (about 1 year ago)
- Last Synced: 2025-01-27T23:47:35.097Z (5 months ago)
- Topics: dns-over-https, dnscrypt-proxy, protective-dns, systemd, ultraddr
- Language: Shell
- Homepage: https://www.vercara.com
- Size: 11.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# uddr_linux_bootstrap
This script demonstrates the setup of Vercara's UltraDDR product on a Linux system, configuring it to use custom DNS over HTTPS (DoH) servers and routing system's DNS queries through `dnscrypt-proxy` for enhanced privacy and blocking.
## Prerequisites
- Ubuntu (I tested this on Ubuntu and adjustments may be needed for other Linux distributions)
- Python
- Sudo privileges
## Installation and Configuration
1. Clone this repository:
```bash
git clone https://github.com/sbarbett/uddr_linux_bootstrap
```
2. Make the setup file executable:
```bash
cd uddr_linux_bootstrap
chmod +x setup.sh
```
3. Execute the script:
```bash
sudo ./setup.sh {client_id)
```
Replace `{client_id}` with your UDDR client UID (it's also called an install key in the settings).
## Script Functions
- Installs `dnscrypt-proxy`.
- Stops/disables any existing `dnscrypt-proxy` service to prevent conflicts.
- Configures `dnscrypt-proxy` to use UDDR DNS resolvers linked to your client ID.
- Adjusts `dnscrypt-proxy` to listen on `127.0.0.5:53`.
- Redirects the system's DNS queries to `dnscrypt-proxy`.
- Applies the configuration changes by restarting related services.
## License
This script is provided under the MIT License. See the LICENSE.md for the full declaration.