Skip to content

Windows Server: standalone evaluation

This is the recommended way to evaluate AppControl on an internal Windows Server. It installs the web interface, backend, gateway and agent without Docker and without a separate database server. Data is stored in an embedded SQLite database.

When to use this mode

Use it for a customer evaluation, a proof of concept, a demo, or a small single-server installation. For a durable shared production service, use Docker Compose on Linux or OpenShift with PostgreSQL.

What you need

  • Windows Server 2019 or later, x64
  • Windows PowerShell 5.1 or later
  • an account allowed to download release assets from GitHub
  • administrator rights only if you enable startup at boot or open firewall ports

Docker, Rust, Node.js and PostgreSQL are not required.

Install in a few minutes

Open PowerShell in the directory where AppControl should keep its data:

New-Item -ItemType Directory -Force C:\AppControl | Out-Null
Set-Location C:\AppControl

Invoke-WebRequest `
  -Uri "https://github.com/xcomponent/appcontrol-release/releases/latest/download/appcontrol.ps1" `
  -OutFile appcontrol.ps1

.\appcontrol.ps1 install -Email "admin@my-company.example" -Password "replace-this-password"
.\appcontrol.ps1 start
.\appcontrol.ps1 add-site "Evaluation"

Open http://localhost:3000, then sign in with the email and password passed to install.

From another workstation, use http://SERVER_NAME:3000 and open the port once in Windows Firewall:

New-NetFirewallRule -DisplayName "AppControl Web" `
  -Direction Inbound -Protocol TCP -LocalPort 3000 -Action Allow

The gateway listens on port 4443 by default. Open that port only when agents on other servers must connect to this gateway:

New-NetFirewallRule -DisplayName "AppControl Gateway" `
  -Direction Inbound -Protocol TCP -LocalPort 4443 -Action Allow

Start automatically after reboot

Run PowerShell as Administrator:

Set-Location C:\AppControl
.\appcontrol.ps1 enable-autostart

This creates a Windows scheduled task running under SYSTEM. To remove it:

.\appcontrol.ps1 disable-autostart

Daily operations

Action Command
Check all processes .\appcontrol.ps1 status
Start .\appcontrol.ps1 start
Stop .\appcontrol.ps1 stop
Read recent logs .\appcontrol.ps1 logs
Add a site .\appcontrol.ps1 add-site "Site name" [gateway-port]
Upgrade .\appcontrol.ps1 upgrade

An upgrade replaces only binaries and the web interface. The database, configuration and site definitions are preserved.

User, team, site, hosting, map and catalog commands are documented once in the PowerShell command reference.

Backup and uninstall

Stop AppControl before copying its data:

.\appcontrol.ps1 stop
Copy-Item C:\AppControl\data C:\Backup\AppControl\data -Recurse -Force
Copy-Item C:\AppControl\config C:\Backup\AppControl\config -Recurse -Force

To uninstall, stop AppControl, disable automatic startup, then archive or remove C:\AppControl. No system-wide database or container runtime remains.

Directory layout

C:\AppControl\
  appcontrol.ps1
  bin\          downloaded executables
  config\       configuration and sites (preserved by upgrade)
  data\         SQLite database and agent state (preserved by upgrade)
  frontend\     web interface
  logs\         component logs

Security boundary

The quick install serves HTTP directly. It is suitable on a protected internal network for evaluation. Do not expose port 3000 to the Internet. For a production deployment, put it behind the company HTTPS reverse proxy, change the initial password, restrict firewall access, and follow the hardening checklist.

Troubleshooting

.\appcontrol.ps1 status
.\appcontrol.ps1 logs
Get-Content .\logs\backend.err.log -Tail 100

If PowerShell blocks the script for the current process:

Set-ExecutionPolicy -Scope Process Bypass