The dashboard requires Kea DHCP for device tracking and hostname resolution. Enable it in pfSense:

# In pfSense Web UI:
System → Advanced → Networking

# Scroll to "DHCP Server Backend"
# Select "Kea DHCP" from the dropdown
# Click "Save"

After saving, go to your DHCP Server settings and click Apply Changes to restart the DHCP service with Kea:

# In pfSense Web UI:
Services → DHCP Server → [Your LAN Interface]

# Click "Apply Changes" at the top

The dashboard displays DNS queries from your network devices. This requires enabling query logging in the DNS Resolver:

# In pfSense Web UI:
Services → DNS Resolver

# Scroll to the bottom and find "Custom options"
# Add the following:

server:
log-queries: yes

# Click "Save" then "Apply Changes"

For country flags and location data on the threat map, download the free GeoLite2 database from MaxMind:

1. Create a free account at MaxMind GeoLite2

2. Download GeoLite2-City.mmdb (the binary .mmdb file, not CSV)

3. Upload it to pfSense:

# Use -P for custom SSH port
scp -P 22 GeoLite2-City.mmdb root@YOUR_PFSENSE_IP:/opt/dashboard/

4. Go to the dashboard Settings page and click Restart Dashboard to load the database. Flags will appear on new threats after the restart.

AbuseIPDB provides threat intelligence data for suspicious IPs. To enable this feature:

1. Create a free account:

Go to https://www.abuseipdb.com/ and click "Sign Up"

2. Get your API key:

• After logging in, go to Account → API
• Click "Create Key"
• Give it a name (e.g., "pfUI Dashboard")
• Copy the generated API key

3. Add the key to pfUI Dashboard:

• In the dashboard, go to Settings
• Paste your API key in the "AbuseIPDB API Key" field
• Click "Save Settings"

The dashboard can send email alerts when your WAN goes down/recovers and when monitored devices go offline. Configure SMTP in Settings:

SMTP Settings:

• SMTP Host: Your email provider's SMTP server
• SMTP Port: 587 (TLS) or 465 (SSL)
• SMTP Username: Your email address
• SMTP Password: Your email password or app password
• From Address: The address emails will be sent from
• Recipients: Up to 3 email addresses to receive alerts

Gmail Setup:

Gmail requires an App Password instead of your regular Google password. Here's how to set it up:

# Gmail SMTP Settings:
SMTP Host:     smtp.gmail.com
SMTP Port:     587
TLS:           Enabled
SMTP Username: [email protected]
SMTP Password: (App Password - see below)
From Address:  [email protected]

How to create a Gmail App Password:

• Go to myaccount.google.com/security
• Enable 2-Step Verification if not already enabled (required for App Passwords)
• Go to myaccount.google.com/apppasswords
• Enter a name (e.g. "pfUI Dashboard") and click Create
• Copy the 16-character password that appears
• Paste it as the SMTP Password in dashboard Settings

Other Email Providers:

# Outlook / Hotmail:
SMTP Host: smtp.office365.com  Port: 587

# Yahoo Mail:
SMTP Host: smtp.mail.yahoo.com  Port: 587

# iCloud Mail:
SMTP Host: smtp.mail.me.com     Port: 587

# Note: Most providers require an App Password.
# Check your provider's security settings.

pfUI includes full WireGuard VPN management. To set it up:

• Click the VPN Config link on the Settings page (or the lock icon in the nav bar)
• Click Create Server to set up a WireGuard server with auto-generated keys
• Add peers and scan the QR code with the WireGuard app on your phone, or download the .conf file for desktop clients

In the Settings page you can also configure:

• Network Detection: Click "Re-Detect Network" to auto-detect your subnets and interfaces
• Password: Change the default admin password
• Session Timeout: Auto-logout after a period of inactivity
• Themes: Switch between dark theme variants
• Backup & Restore: Download or restore a full backup of your dashboard config and data
• Speed Test: Test your WAN download and upload speeds