DoHzel Proxy Installation Guide for Linux#

Introduction#

This guide provides detailed instructions on how to install and configure DOHzel Proxy on a Linux system.

Prerequisites#

DoHzel Proxy is officially supported on Debian 12.

However, it has been successfully tested too on the following Linux distributions:

Ubuntu 24.04
Fedora 40

Download#

You can download the appropriate version of DOHzel Proxy using the following links:

DoHzel Proxy (Linux x64) - Suitable for 64-bit Linux systems
DoHzel Proxy (Linux arm64) - For ARM-based systems such as Raspberry Pi

Installation#

Initialization#

Download the application: Run the following commands as the root user:

cd /root
wget https://download.hafnova.com/dohzel-proxy/dohzel-proxy.linux-x64-latest.bin
chmod +x dohzel-proxy.linux-x64-latest.bin

Install as a systemd service: It is recommended to install DOHzel Proxy as a systemd service:
```
./dohzel-proxy.linux-x64-latest.bin service install
```
Initialize configuration files: Initialize the local configuration files:
```
./dohzel-proxy.linux-x64-latest.bin init
```
Enroll devices: Enroll your devices to receive security updates from ThreadDB:
```
./dohzel-proxy.linux-x64-latest.bin enroll [-n demoDevice]
```
Join Profile: If you already have a profile with a token, you may use it to link the device to the profile:
```
./dohzel-proxy.linux-x64-latest.bin profile join <PROFILE_TOKEN>
```

Status Verification#

To check the status of your DOHzel Proxy installation at any time, use the following command:

./dohzel-proxy.linux-x64-latest.bin status

This command will display various details, including the "Rebound URL," which you can use to manage advanced device settings.

Server Launch#

If installed as a systemd service, start the server with:
```
systemctl start dohzel-proxy.service
```
For standalone mode, launch the server with:
```
dohzel-proxy server
```

Installing DoHzel on distributions with systemd-resolved#

Current Ubuntu and Fedora distribution leverage systemd-resolved as the out-of-the-box resolver. Additional steps must be taken to set DoHzel as the resolver for the system.

Disable systemd-resolved:

systemctl stop systemd-resolved.service
systemctl disable systemd-resolved.service

Set the system resolver: Ensure that the /etc/resolv.conf file contains nameserver 127.0.0.1.
Restart DoHzel service
```
systemctl restart dohzel-proxy.service
```