Skip to content

Quickstart

Choose the environment where AppControl will run. The database is determined by that choice; the two backend binaries are intentionally separate.

Your need Recommended deployment Database Typical setup time
Evaluate on an internal Windows Server Standalone PowerShell Embedded SQLite A few minutes
Run a production service on Windows Server Native Windows services Local or existing PostgreSQL 16 About 10–20 minutes
Evaluate on a Linux server with containers Docker Compose Included PostgreSQL 16 About 10 minutes
Run on Kubernetes Helm External PostgreSQL 16 Platform dependent
Run on OpenShift OpenShift External/operator PostgreSQL 16 Platform dependent

For an isolated OpenShift evaluation with verified internal TLS and a bundled database, use the guided evaluation installer. For bank-approved base images and internal registries, see the deployment audit.

Fastest path: Windows Server

No Docker and no database installation are required:

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. Continue with the Windows Server guide for firewall, automatic startup, backup and upgrade.

Important distinctions

  • Standalone uses the appcontrol-backend-sqlite binary. It is intended for evaluation and small single-host installations.
  • Compose, Kubernetes and OpenShift use the PostgreSQL backend image.
  • Docker Desktop is not supported on Windows Server. If containers are required on Windows infrastructure, run the Compose stack in a Linux VM.
  • Do not expose a quickstart directly to the Internet. Apply the hardening checklist before production use.

Windows production path

For a durable Windows Server installation, do not start with the SQLite quickstart. Open Windows PowerShell as Administrator and install the PostgreSQL variant:

New-Item -ItemType Directory -Force C:\AppControl-Install | Out-Null
Set-Location C:\AppControl-Install
Invoke-WebRequest `
  -Uri "https://github.com/xcomponent/appcontrol-release/releases/latest/download/appcontrol-windows-server.ps1" `
  -OutFile appcontrol-windows-server.ps1

.\appcontrol-windows-server.ps1 install `
  -PostgresMode Install `
  -AdminEmail "admin@my-company.example" `
  -AdminPassword "replace-this-password"

Continue with Windows Server production. Every installer parameter is explained in the PowerShell command reference.

Banking reconstruction demonstrator

The isolated demo is launched with ./demo-rebuild/scripts/start-codespace-demo.sh. It generates a private .devcontainer/.env, preserves it across restarts and keeps Codespaces ports private. Passwords are verified; an existing database requires its existing administrator password on first migration. Run ./demo-rebuild/scripts/demo-control.sh verify before presenting. See the demo runbook for incidents, reset and the opt-in full-stack recipe. The workload, business figures and external tools are explicit simulators; backend, gateway, agents and HTTP job calls are real.