Qoc

Install on Windows

Step-by-step instructions for installing the Qoc CLI on Windows using winget, Scoop, or the standalone installer.

Install qoc on Windows via winget, Scoop, or the standalone .msi installer — all three paths produce the same binary and support the full CLI.

Prerequisite: Node 20+

Run node --version in PowerShell before proceeding. If Node is not installed, the winget path below installs it automatically as a dependency. For manual installation, download Node.js v20 LTS from nodejs.org.

Option A — winget (recommended for Windows 11)

  1. 1

    Install via winget

    Open PowerShell as a standard user (no elevation required) and run the winget install command. winget resolves the Node.js dependency automatically.

  2. 2

    Reload your PATH

    Close and reopen PowerShell so the new qoc entry is on your PATH. Run qoc --version to confirm.

  3. 3

    Start the desk service

    Run qoc up in PowerShell. The service binds to localhost:7070. To run it as a background service, append --daemon.

  4. 4

    Verify

    Open a new PowerShell window and run qoc status. Confirm the version number and service running appear in the output.

winget install command

Run in PowerShell
powershell
winget install qoc-app.qoc

Option B — Scoop

  1. 1

    Add the Qoc bucket

    Run scoop bucket add qoc https://github.com/qoc-app/scoop-bucket to register the bucket.

  2. 2

    Install

    Run scoop install qoc. Scoop places the binary in ~/scoop/shims/, which is already on your PATH if Scoop is set up correctly.

  3. 3

    Start and verify

    Run qoc up, then qoc status in a new terminal to confirm everything is working.

Scoop install commands

powershell
scoop bucket add qoc https://github.com/qoc-app/scoop-bucket
scoop install qoc
qoc up
qoc status

Option C — standalone installer

Download the qoc-setup-x64.msi from https://qoc.app/download and run it. The installer places the binary in C:\Program Files\Qoc\bin and adds that directory to the system PATH. Node.js must already be installed before running the .msi.

After the installer completes, open a new PowerShell window and run qoc status to verify.

Using WSL

If you prefer a Linux environment, install qoc inside Windows Subsystem for Linux (WSL 2) using the macOS/Linux install script. The desk service running inside WSL is accessible from Windows at localhost:7070 via WSL's automatic port forwarding.

Note that your workspace directory should live inside the WSL filesystem (e.g., ~/qoc-desk) for best performance. Accessing Windows drives through /mnt/c/... works but is significantly slower for file-intensive agent tasks.

Antivirus false positives

Some Windows antivirus products flag newly downloaded binaries until they accumulate a reputation score. If Defender quarantines qoc.exe, add an exclusion for C:\Program Files\Qoc\bin\qoc.exe in Windows Security settings, or verify the binary checksum published on qoc.app before allowing it.

What to do next

Quick start

Initialise a workspace, connect a practice venue, and approve your first trade.

Configuration reference

Learn every key in `desk.toml` and how to tune guards and data sources.

PreviousInstall on macOSNext Quick start