SNACBox

Simple Network Access Control Box (SNACBox) is a home gateway that provides child-safe internet access, protects devices, and restricts access based on the user’s devices. SNACBox aims to help parents and guardians create a child-safe internet experience.

Device Access

ADGuardHome Dashboard

Open Source Components

OpenWRT

AdguardHome

Docker

e2Guardian

Unbound

PHP

Functionality

SNACBox Design

How to Configure SNACBox

New OpenWRT Setup

Compatible Hardware

Openwrt 25.12+ Supported Firmware

FriendlyArm NanoPi R3S

Waveshare Dual Gigabit CM4 Board

Waveshare USB Gigabit Eth Hat for Pi 4B

Click and download the firmware

Flash SD Card

Get an SD card (minimum 16 GB) < br> Download and install Raspberry Pi Imager https://www.raspberrypi.com/software/
Insert the SD card into a computer or adapter
Run Raspberry Pi Imager
Raspberry Pi Imager Step 1
Click “Select Hardware” Raspberry Pi Imager Step 2
Choose Hardware Raspberry Pi Imager Step 3
Click “Select OS” Raspberry Pi Imager Step 4
Choose “Custom Image” Raspberry Pi Imager Step 5
Click “Select Storage” Raspberry Pi Imager Step 6
Choose SD Card Raspberry Pi Imager Step 7
Click “No” to customise the OS Raspberry Pi Imager Step 8
Click “Complete” Raspberry Pi Imager Step 9
The SD card is now almost ready for use in the device. < br> Make sure your device is not connected to a network or power

Boot OpenWRT 25.12+

Insert the SD card into the device. < br> Power on or boot the device. < br> Connect the LAN port directly to a computer; the device will provide the computer with a new DHCP address. < br> Open a web browser on the computer and enter http://192.168.1.1 to access OpenWRT
Configure OpenWRT Password
SSH to root@192.168.1.1

ssh root@192.168.1.1

SNACBox Installation

The SNACBox APK package is built for OpenWRT 25.12+.
This package create SNACBox using a clean, fresh OpenWRT install.
It is not recommended to run this package on an existing OpenWRT installation, as it will overwrite firewall, network and AdGuardHome configurations.
Test the network first:

nslookup downloads.openwrt.org
apk update

Download the package:

wget --no-check-certificate https://github.com/AKrawczyk/SNACBox/raw/refs/heads/main/software/luci-app-snacbox-1.0.0-r1.apk

Install SNACBox package and reboot

apk add --allow-untrusted luci-app-snacbox-1.0.0-r1.apk
reboot
clear

After the box reboots, log in to https://192.168.12.1 and ssh root@192.168.12.1 to verify and complete the configuration.
The SNACBox is almost ready to be installed on a Home Network Router and provide safe internet.
Before using the SNACBox, make sure you set the system password.

Set and Configure System Password

  1. Go to ‘System’ -> ‘Administration’ -> ‘Router Password’
    2. Enter a new password
    3. Press ‘Save’
    4. Goto ‘Webguard’ -> ‘Web Access’ -> ‘Configuration’
    5. Enter the newly set password in the ‘System Password’ field.
    6. Press ‘Save & Apply’

    SNACBox is ready to be set up for use on a home network.

Set up SNACBox on Home Network Router

Note: This setup currently requires simple IT skills.

Step 1

Connect SNACBox WAN port to Home Router
SNACBox Connectivity

  1. Power on the SNACBox
    2. Connect one of the Home Router’s network ports to the SNACBox WAN port
    3. Connect the SNACBox LAN port to the USB Network Dongle’s network port
    4. Connect the USB Network Dongle’s USB port to Laptop/Tablet/Smart Phone usb port
    5. Browse to https://192.168.12.1
    6. Login to SNACBox, User = root, Password = xxxxxx

Configure Static WAN IP

Go to Webguard -> Web Access
Select ‘Configure’
Click the button ‘Reset WAN’

Setup Admin USB Network Dongle

Go to Webguard -> Web Access
Select ‘Device Access’
Now set the Rating to ‘18-Rated’ for the admin USB network dongle

Screenshot

Enable SNACBox on Home Router

  1. Disconnect the USB Network Dongle from Laptop/Tablet/Smart Phone
    2. Disconnect the SNACBox LAN port from the USB Network Dongle

    3. Log in to the home router and disable DHCP
    Note: Consult the Home Router supplier’s web page for information on how to do this.
    Note: DNS configuration may be necessary if the Home Router is set to secure DNS.

    4. Connect the SNACBox LAN port to the Home Router Network port.

Step 2

Set up admin devices
Connect at least two wireless devices (Computer, Tablet, Smart Phone) to Home WiFi
If you’re using a mobile device (iOS, macOS, or Android) make sure to configure the WiFi connection’s Private Wi-Fi Address to ‘Fixed’

Apple MAC Random
Apple MAC Fixed

Note: These devices will automatically be enrolled into the ‘No Access’ rating. < br>

  1. Open a web browser and go to http://192.168.12.1
  2. Login to SNACBox, User = root, Password = xxxxxx
  3. Now set the Rating to ‘18-Rated’ for both admin devices

Screenshot

  1. Once the admin devices have been enabled, proceed to step 3 to enable security and set the time.

Step 3

Enable SNACBox security

Goto Webguard -> Web Access
Select ‘Configure’
Tick ‘Enable Enhanced Security’

Set Time

Click on ‘System -> System’
Find the ‘Timezone’ dropdown list
Select the correct timezone

Device Setup

Now everything should be set up, and all devices connected to the Home WiFi should be appearing in the ‘Device Access’ web interface. All devices will automatically be enrolled on the ‘No Access’ rating. < br> < br>

  1. Enable devices on the home network < br>
  2. https://192.168.12.1 -> Web Guard -> Web Access -> Device Access
  3. All devices trying to access the Home WiFi will have a ‘No Access’ rating automatically applied to them, but will have a ‘Captive Portal’ webpage appear showing their IP address.

Captive Portal

  1. Now find that device on the list of devices in ‘Device Access’ and assign it the necessary access rights (G, PG, 12, 15, 16 or 18).
    The PDF contains detailed information regarding age rated filter configuration SNACBox Age Rated Filters.pdf

Device Access