nproxy setup
nproxy setup is the single install flow. It creates .nproxy/contract.json, starts the passive daemon, applies detected native projectors, offers optional bindings, and verifies local protection before the dashboard marks setup complete.
Usage
npx nproxy setup [slug] [options]
Arguments
| Argument | Required | Description |
|---|---|---|
slug | No | Organization slug. If omitted, nproxy reads existing config and then falls back to public. |
Options
| Flag | Alias | Description |
|---|---|---|
--token <token> | Use an org API token for policy sync. | |
--port <port> | Local proxy port. Default: 4873. | |
--ecosystem <list> | Configure only selected ecosystems, for example npm,pip. | |
--all | Configure every detected ecosystem. | |
--yes | Use safe defaults without prompting. | |
--bindings | Create optional bindings from detected env files in observe mode. | |
--remove | Remove nproxy package-manager config. | |
--global | -g | Compatibility path for cloud .npmrc setup. |
What it does
- Resolves the org slug and token.
- Detects package managers and common runtime files.
- Writes or refreshes
.nproxy/contract.json. - Configures selected package managers through
http://127.0.0.1:4873. - Installs wrapper scripts and starts the passive daemon.
- Projects optional bindings and runtime config when requested.
- Runs verification and reports success to the dashboard.
Examples
npx nproxy setup acme
npx nproxy setup acme --yes
npx nproxy setup acme --ecosystem npm,pip
npx nproxy setup acme --bindings
npx nproxy setup --remove --ecosystem npm
Notes
- Bindings are optional. Env vars keep working unless you opt into binding capabilities.
--yesdoes not enable bindings.- Runtime integration is native: PM2, Docker, Kubernetes, Cloudflare, and CI use projected config instead of an app-specific launch wrapper.
- The dashboard marks setup complete only after the CLI verifies the local proxy.
Troubleshooting
Crash-looping launchd service
If your launchd service was installed before this fix and is crash-looping, repair it:
launchctl unload ~/Library/LaunchAgents/app.nproxy.daemon.plist
: > ~/.nproxy/daemon/proxy.err.log
nproxy setup --local