NetClamp docs

Getting started

This walks through installing NetClamp, pairing the browser SPA, and creating a first rule. Five minutes start to finish.

System requirements

  • Windows 10 1903 or newer / Windows 11

  • Administrator rights for the install (creates a Windows Service)

  • 200 MB free disk space

  • Test-signing mode (bcdedit /set testsigning on + reboot) is only needed if you want kernel-mode rate-limit precision. The userspace fallback covers ALLOW and BLOCK perfectly and gives coarse rate-limiting too — most users never need the kernel driver.

Install

  1. Download NetClamp-Setup-X.Y.Z.exe from netclamp.com.

  2. Right-click → Run as administrator. The installer is signed with an EV code-signing certificate; UAC will show Verified Publisher: Szallo Laszlo Persoana Fizica Autorizata.

  3. Accept the defaults. The installer:

    • Drops binaries into C:\Program Files\NetClamp\

    • Registers NetClamp Windows Service (auto-start)

    • Registers NetClampKdrv kernel driver (demand-start; only loads if test-signing is on)

    • Adds C:\Program Files\NetClamp to system PATH so netclamp.exe is reachable from any shell

    • Launches the tray

  4. Look for the NetClamp icon in the system tray (notification area).

The service generates an authentication token on first boot at C:\ProgramData\NetClamp\auth.token. Every API call needs that token as a Bearer header.

Pair the SPA

Two ways:

  1. Click the tray icon → it opens the SPA in your default browser with the token already in the URL fragment. Recommended.

  2. Manual — open http://127.0.0.1:9845/ in any browser. You’ll land on /setup. Paste the token from C:\ProgramData\NetClamp\auth.token into the field and click Pair browser.

    Or skip the form: visit http://127.0.0.1:9845/#token=<the-token-value>;. The fragment is captured into localStorage on first load and the URL is scrubbed.

You’ll land on the Dashboard. Live bandwidth chart, connection count, top apps — all flowing within a second or two.

Create your first rule

Goal: rate-limit firefox.exe to 500 KB/s download.

  1. Click Rules in the left nav → + New rule.

  2. Fill in the form:

    Name

    Firefox 500 KB/s

    Match target

    App by path

    App path

    C:\Program Files\Mozilla Firefox\firefox.exe

    Action

    Rate limit

    Direction

    Both

    Rate (down)

    500 KB/s

    Rate (up)

    leave blank (no upload cap)

    Priority

    100 (default)

  3. Click Save rule. The row appears with sync_state: synced within a couple seconds. If it stays on pending_* or flips to broken, the Troubleshooting page has the recovery steps.

  4. Open Firefox, start a large download. Watch the Dashboard — the Firefox row should hover at ~500 KB/s.

To remove the cap: hit Delete on the rule row. Firefox is uncapped within milliseconds.

Next steps

  • Rules — every field explained, including the Advanced section (remote address, port, protocol).

  • Quotas — set "Spotify gets 1 GB/day" budgets that alert + clamp when busted.

  • Rule groups — install a curated bundle from disk or subscribe to an HTTPS URL for fleet-wide policies.

  • Licensing — free baseline is 3 managed entities (rules + quotas). Need more? Buy credits, each adds 10.