Part 1: Install on Debian 12 or Raspberry PI

Note

If possible, always prefer to use the fully configured virtual appliance on your own VMware vSphere/ESXi or Microsoft Hyper-V infrastructure or in Microsoft Azure. Moving on to the new version of DNS Safety will be so much easier!

The following steps show how to install core part of DNS Safety on 64-bit Debian 12 or Raspberry PI. It is recommended to download installation scripts mentioned on each step from our GitHub repository (look for subfolder named core.debian12). Just run the scripts one by one as root.

Step 1. Update System

It is recommended to update the system prior to installation. Run bash 01_update.sh in the console.

#!/bin/bash

# update should be done as root
if [[ $EUID -ne 0 ]]; then
   echo "This script must be run as root" 1>&2
   exit 1
fi

# update, upgrade and reboot
apt update && apt -y upgrade && reboot

Step 2. Install DNS Server

Run bash 02_dnssafety.sh in the console to install the latest stable version of DNS Safety. Note the /opt/dnssafety/bin/dsdnsd daemon runs as standard daemon user in Linux.

#!/bin/bash

# all packages are installed as root
if [[ $EUID -ne 0 ]]; then
   echo "This script must be run as root" 1>&2
   exit 1
fi

# default arc
MAJOR="2.0.0"
MINOR="E963"
ARCH="amd64"

# see if it is RPI or not?
cat /proc/cpuinfo | grep -m 1 ARMv7 > /dev/null 2>&1
if [ $? -eq 0 ]; then
    ARCH="armhf"
fi

# install some utils
apt install -y wget

# download
wget https://packages.diladele.com/dnssafety-core/$MAJOR.$MINOR/$ARCH/release/debian12/dnssafety-$MAJOR.${MINOR}_$ARCH.deb

# install
dpkg --install dnssafety-$MAJOR.${MINOR}_$ARCH.deb

# relabel folder
chown -R daemon:daemon /opt/dnssafety

Step 3. Integrate

Finally run bash 03_integrate.sh in the console to integrate DNS Safety into the system. For Debian 11 integration is simple, it just restarts the dsdnsd daemon.

#!/bin/bash

# all packages are installed as root
if [[ $EUID -ne 0 ]]; then
   echo "This script must be run as root" 1>&2
   exit 1
fi

# and restart dns safety dns server
systemctl restart dsdnsd

Now continue on to part 2 to install the Admin UI for DNS Safety.