maxoperf/outpost-agent repository overview

⁠MaxoPerf Outpost — self-hosted load testing runners for Docker and Kubernetes

Run performance tests from inside your own network. MaxoPerf Outpost is a lightweight agent that turns any Docker host or Kubernetes cluster into a private load-testing runner pool — BYOC (bring your own cloud). Point it at staging behind your VPN, at an internal API with no public route, or at a service that only accepts traffic from your VPC. MaxoPerf runs the scheduling, results ingestion, and reporting; your traffic and your test data never leave your infrastructure.

The agent dials outbound only. No inbound ports. No firewall exceptions. No VPN peering.

• 🔒 Outbound-only gRPC — one long-lived control stream to MaxoPerf; nothing listens on your network
• 🐳 Docker or ☸️ Kubernetes — one image, both runtimes
• 🧪 Taurus-powered — JMeter, k6, Gatling, Locust, Selenium and more, from one YAML config
• 📊 Hosted results — live metrics, trends, and failure criteria in the MaxoPerf console
• ⚙️ Capacity you control — cap concurrent runners, CPU, and memory per datacenter

📚 BYOC Outpost guide⁠ · 🚀 Start free⁠ · 🌐 maxoperf.com⁠

⁠Quick start (Docker)

Generate an install JWT in the console (Private datacenters → Generate install JWT), then:

docker run -d --name maxoperf-outpost-agent --restart unless-stopped \
  -e MAXOPERF_API_BASE_URL=https://api.maxoperf.com \
  -e MAXOPERF_CONTROL_GRPC_URL=grpc.maxoperf.com:443 \
  -e MAXOPERF_PDC_ID=<your private datacenter id> \
  -e MAXOPERF_OUTPOST_INSTALL_JWT=<install JWT from the console> \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.io/maxoperf/outpost-agent:latest agent

The agent enrolls, reports ready, and starts accepting runs. Watch it come online in the console.

⁠Quick start (Kubernetes)

The console generates a complete, one-shot manifest — Namespace, ServiceAccount, Role, RoleBinding, Secret, Deployment — with the install JWT already embedded:

kubectl apply -f maxoperf-outpost-install.yaml

Helm remains the advanced path when you need overlays, image pre-pull, or GitOps.

⁠Pin by digest (recommended for production)

:latest is a moving tag. For reproducible installs, pin the digest:

docker pull docker.io/maxoperf/outpost-agent@sha256:<digest>

Copy the digest from the Tags tab above, or read it back yourself:

docker buildx imagetools inspect docker.io/maxoperf/outpost-agent:latest

⁠Supported tags

Platform: linux/amd64.

⁠Configuration

Raise verbosity or switch to JSON logs without rebuilding the image — both are plain env vars.

⁠Security

• Outbound only. The agent opens one gRPC control stream to MaxoPerf. Nothing binds an inbound port, so no ingress rule, port-forward, or VPN peering is required.
• Your traffic stays yours. Load is generated inside your network, against your targets. MaxoPerf receives metrics and run state, not your payloads.
• Treat the install JWT like a password. Store it in a Kubernetes Secret or a Docker secret — never in a ticket, a chat message, or a committed file. Rotate it from the console.
• Logs are redacted. Credentials and registry auth never appear in agent output.

⁠Pull rate limits

Anonymous Docker Hub pulls are rate-limited per IP. If you pull the agent from CI or across a large fleet behind a single NAT address, run docker login first, or pre-pull the image into an internal registry or cluster cache.

⁠Links

• 📚 BYOC Outpost guide — https://maxoperf.com/docs/guides/byoc-outpost⁠
• 🧭 Docs — https://maxoperf.com/docs⁠
• 🚀 Console — https://app.maxoperf.com⁠
• 🌐 MaxoPerf — https://maxoperf.com⁠

MaxoPerf is a performance-testing platform: load testing, browser testing, synthetic monitoring, and real-user monitoring, with runners you can host yourself.