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.