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.