Skip to content
← Documentation

System Integration

System Integration

CyberWall integrates deeply with Windows through system tray, Windows Service, and auto-start capabilities.


System Tray

Tray Icon

The system tray icon shows:

  • Current firewall mode (color-coded)
  • Network activity indicator
  • Right-click context menu

Icon States

State Appearance
Active Normal icon (filtering enabled)
Disabled Grayed out
Killswitch Red indicator
Activity Animated on network events

Context Menu

Right-click the tray icon for:

Action Description
Show/Hide Toggle main window
Firewall mode Switch between modes
View Log Open connection log
Settings Open settings window
About Show about dialog
Exit Close CyberWall

Windows Service

Service Mode

CyberWall can run as a Windows Service:

  • Runs as SYSTEM account
  • No user interface
  • Always active filtering
  • Survives user logoff

Service Installation

Install the service via PowerShell (admin):

.\installer\install.ps1

Service Benefits

Benefit Description
Always on Filtering even when UI is closed
SYSTEM privileges Full network access control
No UAC prompts Installed once, runs always
Boot protection Active from system startup

Service + UI

Run both service and UI:

  • Service handles filtering
  • UI handles prompts and management
  • Communication via named pipes

Auto-Start

Launch with Windows

CyberWall can start automatically:

  • Settings → General → Run at Startup
  • Or: Windows Settings → Apps → Startup

Start Minimized

Option to start hidden:

  • App runs in system tray
  • No main window on startup
  • Access via tray icon

Minimize to Tray

Close button behavior:

  • Minimize to tray — Close sends to tray
  • Exit — Fully closes the app

Auto-Update

How It Works

  1. CyberWall checks GitHub Releases on startup
  2. When an update is available, a toast appears
  3. Download with progress indicator
  4. Installer launches when complete

Update Settings

Setting Description
Auto-check Enable/disable update checking
Check on startup Check when app launches

Manual Update

  1. Go to Settings → About → Check for Updates
  2. Or: Download latest installer from releases

Multi-Monitor Support

Display Awareness

CyberWall adapts to multi-monitor setups:

  • Main window appears on active monitor
  • Notifications on selected monitor
  • Prompts appear on cursor monitor

Monitor Settings

Setting Description
Notification monitor Which monitor shows toasts
Window position Remember position per monitor

Data Storage

File Locations

File Path
Rules %ProgramData%\CyberWall\rules.json
Settings %ProgramData%\CyberWall\settings.json
Connection log %ProgramData%\CyberWall\blocked.log
Notifications %ProgramData%\CyberWall\notifications.json
GeoIP database %ProgramData%\CyberWall\geo\

Data Portability

All data is in standard formats:

  • JSON for rules and settings
  • Plain text for logs
  • Easy to backup and transfer