@postman/cloud-agent-worker

Postman Cloud Agent Worker

Runs Postman Cloud Agent tasks inside your own network, so the agent can work with a self-hosted git provider and other services Postman's cloud cannot reach.

Your git credentials stay on your machine. Postman never receives them.

1. Prerequisites

Node 22+ and Docker. Every task runs in its own container.

2. Install

npm install -g @postman/cloud-agent-worker

3. Configure

Create ~/.postman-worker/config.json:

{
  "postmanAccessToken": "<your Postman access token>",
  "git": {
    "provider": "gitlab",
    "host": "https://gitlab.internal.example.com",
    "token": "<your GitLab access token>"
  }
}

4. Start

postman-cloud-agent-worker start

The worker only makes outbound connections — no ports to open, nothing to expose. It logs Registered with orchestrator — polling for work once it is ready.

Run it under systemd, Docker, or your usual process supervisor. You can run several sharing the same config; tasks are spread across them.

More

postman-cloud-agent-worker --help     # every setting and environment variable
WORKER_LOG_LEVEL=debug postman-cloud-agent-worker start

debug traces every call the worker makes — URL, status, elapsed time — which is usually enough to tell a bad token from an unreachable host.