Windows Installation
Install the VigilPrism server on Windows Server or Windows 10/11.
Prerequisites
- Administrator access
- Windows Server 2019/2022 or Windows 10/11
- 2+ CPU cores, 4 GB RAM minimum
- 20 GB available disk space
GUI Installer
The easiest way to install VigilPrism on Windows:
- 1Download the Windows installer from the Downloads page
- 2Run the installer as Administrator
- 3Follow the installation wizard
- 4The service starts automatically after installation
The installer creates a Windows service, configures firewall rules, and sets up all necessary directories.
PowerShell Installation
For automated or silent installation, use PowerShell (run as Administrator):
1. Download and Extract
# Create install directory
New-Item -ItemType Directory -Path "C:\Program Files\VigilPrism" -Force
# Download
Invoke-WebRequest -Uri "https://download.vigilprism.com/server/latest/windows-x64.zip" `
-OutFile "$env:TEMP\vigilprism-server.zip"
# Extract
Expand-Archive -Path "$env:TEMP\vigilprism-server.zip" `
-DestinationPath "C:\Program Files\VigilPrism"
2. Create Configuration
# Create config directory
New-Item -ItemType Directory -Path "C:\ProgramData\VigilPrism\config" -Force
New-Item -ItemType Directory -Path "C:\ProgramData\VigilPrism\data" -Force
New-Item -ItemType Directory -Path "C:\ProgramData\VigilPrism\logs" -Force
# Create config file
@"
host: 0.0.0.0
port: 8000
secret_key: your-256-bit-secret-key-here
database_url: sqlite:///C:/ProgramData/VigilPrism/data/vigilprism.db
"@ | Out-File "C:\ProgramData\VigilPrism\config\server.yaml" -Encoding UTF8
3. Install Windows Service
# Install service
& "C:\Program Files\VigilPrism\vigilprism-server.exe" install
# Start service
Start-Service VigilPrismServer
# Set to auto-start
Set-Service -Name VigilPrismServer -StartupType Automatic
4. Configure Firewall
New-NetFirewallRule -DisplayName "VigilPrism Server" `
-Direction Inbound -Protocol TCP -LocalPort 8000 `
-Action Allow
Service Management
Common commands for managing the VigilPrism service:
# Check status
Get-Service VigilPrismServer
# Start service
Start-Service VigilPrismServer
# Stop service
Stop-Service VigilPrismServer
# Restart service
Restart-Service VigilPrismServer
# View recent logs
Get-Content "C:\ProgramData\VigilPrism\logs\server.log" -Tail 50
Verify Installation
# Check service status
Get-Service VigilPrismServer
# Test health endpoint
Invoke-RestMethod -Uri "http://localhost:8000/health"
# Or open in browser
Start-Process "http://localhost:8000"
The dashboard should be accessible at http://localhost:8000
Default Credentials
The default login credentials are:
Username: admin
Password: admin
Change these immediately after first login!
IIS Reverse Proxy (Optional)
For production deployments with TLS, you can use IIS as a reverse proxy:
- 1Install URL Rewrite and Application Request Routing modules
- 2Enable ARR proxy mode in IIS Manager
- 3Create URL rewrite rule to proxy to localhost:8000
- 4Configure TLS binding with your certificate
Alternatively, you can use Caddy for Windows which provides automatic HTTPS with simpler configuration.
Troubleshooting
Service won't start
Check the Event Log for errors:
Get-EventLog -LogName Application -Source VigilPrism -Newest 20
Port already in use
Check what's using port 8000:
netstat -ano | findstr :8000
Cannot access from other machines
Verify Windows Firewall rule exists:
Get-NetFirewallRule -DisplayName "VigilPrism*"
Database errors
Ensure the data directory is writable:
icacls "C:\ProgramData\VigilPrism\data"
Uninstallation
# Stop and remove service
Stop-Service VigilPrismServer
& "C:\Program Files\VigilPrism\vigilprism-server.exe" uninstall
# Remove files
Remove-Item "C:\Program Files\VigilPrism" -Recurse -Force
# Remove data (optional - keeps your data)
# Remove-Item "C:\ProgramData\VigilPrism" -Recurse -Force
# Remove firewall rule
Remove-NetFirewallRule -DisplayName "VigilPrism Server"