Skip to content
← Documentation

Installation & Setup

Installation & Setup

This guide covers installing CyberWall, building from source, and running as a Windows Service.

System Requirements

Requirement Minimum
OS Windows 10 (64-bit) or later
Architecture x64 or ARM64
Privileges Administrator (required for WFP)
Runtime .NET 10 (included in installer)
Disk space ~100 MB

Installation Methods

Installer (Recommended)

  1. Download the latest installer from Releases
  2. Run the .exe installer (requires Administrator)
  3. Follow the setup wizard
  4. Choose shortcuts and auto-start options
  5. Launch CyberWall

Portable ZIP

  1. Download the portable ZIP from releases
  2. Extract to any folder
  3. Run CyberWall.UI.exe as Administrator

What the Installer Does

  • Installs the application
  • Creates Start Menu shortcuts
  • Creates Desktop shortcut (optional)
  • Adds auto-start entry (optional)
  • Registers the firewall provider

Building from Source

Prerequisites

Tool Version
.NET 10 SDK Latest
Windows 10/11 For WFP development

Build

# Build the solution
dotnet build

# Run with Administrator privileges (real WFP filtering)
.\dev-admin.ps1

# Run standard dev session (simulated if non-elevated)
.\dev.ps1

# Run with separate Service process
.\dev.ps1 -WithService

Publish

# Publish self-contained for x64
dotnet publish src/CyberWall.UI/CyberWall.UI.csproj -c Release -r win-x64 --self-contained true -o ./publish-win64
dotnet publish src/CyberWall.Service/CyberWall.Service.csproj -c Release -r win-x64 --self-contained true -o ./publish-win64

Windows Service

Installing the Service

Run PowerShell as Administrator:

.\installer\install.ps1

Service Benefits

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

Service Management

Action Command
Start net start CyberWall
Stop net stop CyberWall
Uninstall .\installer\install.ps1 -Uninstall

Auto-Start

Enable/Disable

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

Start Minimized

  • Settings → General → Start Minimized
  • App starts in system tray

Uninstallation

Standard Uninstall

  1. Windows Settings → Apps → Installed Apps
  2. Find CyberWall → Click Uninstall

What Gets Removed

  • Program files
  • Start Menu shortcuts
  • Auto-start entry
  • Firewall provider registration

What Is Kept

  • Rules and settings (in %ProgramData%\CyberWall)
  • Connection logs

⚠️ To remove all data, manually delete %ProgramData%\CyberWall after uninstalling.