unifi-toolkit

unifi-toolkit

Docker app from ZappyZap's Repository

Overview

A comprehensive suite of tools for UniFi network management and monitoring.

Readme

View on GitHub

UnRAID UniFi Toolkit Installation Guide

Follow these steps to get the UniFi Toolkit up and running on your UnRAID server.

1. Install UI Toolkit

Open your UnRAID dashboard, navigate to the Apps tab, search for UI Toolkit, and install it.

2. Configure Permissions & Encryption

Open your Terminal and execute the following commands to set the correct folder permissions and generate a unique encryption key:

# Set folder permissions
chown 1000:1000 /mnt/user/appdata/unifi-toolkit

# Generate your unique Encryption Key
docker run --rm python:3-slim sh -c "pip install -q cryptography && python -c 'from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())'"

[!IMPORTANT] Copy the last line of the output from the terminal. Go back to your Docker template, paste it into the field labeled "Encryption Key", and click Apply.

3. Finalize Setup

To complete the configuration, follow the detailed walkthrough provided by Crosstalk Solutions in the video below:

Thanks to filthy on Unraid forum

Install unifi-toolkit on Unraid in a few clicks.

Find unifi-toolkit in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for unifi-toolkit Review the template variables and paths Click Install
Explore Unraid OS

Requirements

IMPORTANT: Create this directory on the host first with correct permissions:
     # chown 1000:1000 /mnt/user/appdata/unifi-toolkit"

Categories

ProductivityTools > Utilities

Related apps

Explore more like this

Explore all
ProductivityUtilities apps

Links

Projectgithub.comSupportforums.unraid.netRegistrygithub.comTemplateraw.githubusercontent.com

Details

Repository
ghcr.io/crosstalk-solutions/unifi-toolkit:latest
Registry
https://github.com/Crosstalk-Solutions/unifi-toolkit
Last Updated2026-07-15
First Seen2026-02-19

Runtime arguments

Web UI
http://[IP]:[PORT:8000]
Network
bridge
Shell
sh
Privileged
false
Extra Params
--restart=unless-stopped

Template configuration

WebuiPorttcp
Target
8000
Default
8000
Value
8000
Data DirPathrw

IMPORTANT: Create this directory on the host first with correct permissions: # chown 1000:1000 /mnt/user/appdata/unifi-toolkit

Target
/app/data
Default
/mnt/user/appdata/unifi-toolkit
Value
/mnt/user/appdata/unifi-toolkit
Encryption KeyVariable

Encryption key for securing UniFi credentials stored in the database

Target
ENCRYPTION_KEY
Value
test
Log LevelVariable

Log level: DEBUG, INFO, WARNING, ERROR, CRITICAL

Target
LOG_LEVEL
Default
INFO
Value
INFO
Database URLVariable

Database URL (default uses SQLite in data/ directory)

Target
DATABASE_URL
Default
sqlite+aiosqlite:///./data/unifi_toolkit.db
Value
sqlite+aiosqlite:///./data/unifi_toolkit.db
Type of deployementVariable

Deployment type: local or production - local: No authentication, access via http://localhost:8000 - production: Authentication required, HTTPS via Caddy

Target
DEPLOYMENT_TYPE
Default
local
Value
local
Stalker Refresh IntervalVariable

Wi-Fi Stalker: Device refresh interval in seconds

Target
STALKER_REFRESH_INTERVAL
Default
60
Value
60
UsernameVariable

Admin credentials (production only)

Target
AUTH_USERNAME
password hashVariable

Admin credentials (production only) Generate with ./reset_password.sh

Target
AUTH_PASSWORD_HASH