Jenkins Cloud

The Jenkins Cloud plugin sends build, test, stage, and agent data to the BuildButler hosted backend. Data is stored in an isolated database per organization and viewed in the BuildButler web app at app.buildbutler.dev.

How it works

┌──────────────────────┐         ┌───────────────────────────────────────────┐
│  Your Infrastructure │         │           BuildButler Cloud               │
│                      │  HTTPS  │                                           │
│  ┌────────────────┐  │────────▶│  ┌──────────┐   ┌─────────────────────┐  │
│  │    Jenkins     │  │         │  │ REST APIs│──▶│  Isolated Postgres  │  │
│  │  (+ plugin)    │  │         │  └──────────┘   │  + Object Storage   │  │
│  └────────────────┘  │         │                 └─────────────────────┘  │
└──────────────────────┘         │                          │               │
                                 │           ┌──────────────▼─────────────┐ │
                                 │           │  BuildButler Web App        │ │
                                 │           │  app.buildbutler.dev        │ │
                                 │           └────────────────────────────┘ │
                                 └───────────────────────────────────────────┘

Each organization gets its own isolated database — your data is never adjacent to another customer's data.

Prerequisites

• Jenkins 2.387.3 or later
• Outbound HTTPS access from Jenkins to api.buildbutler.dev
• A BuildButler account at app.buildbutler.dev
• Java 11+

Installation

1. Download the buildbutler-cloud.hpi plugin from the Downloads page.
2. In Jenkins, go to Manage Jenkins → Plugins → Advanced.
3. Under Deploy Plugin, upload the .hpi file and click Deploy.
4. Restart Jenkins when prompted.

Configuration

Step 1 — Generate an API key

In the BuildButler web app, go to Settings → Connections → Add Jenkins Instance and generate an API key. Copy it — you'll need it in the next step.

Step 2 — Configure the plugin in Jenkins

Go to Manage Jenkins → BuildButler Cloud and fill in:

API Key:     bb_live_xxxxxxxxxxxxxxxxxxxx
Server Name: Production Jenkins
Region:      US East (or your nearest region)

Click Test Connection to verify the plugin can reach the BuildButler API, then Save.

Step 3 — Verify data is flowing

Trigger a build in Jenkins. Within a few seconds it should appear in the Build Results page in the BuildButler web app.

Data ingested

The plugin hooks into the Jenkins build lifecycle and sends:

Storage

Data is stored in:

• PostgreSQL — build metadata, test results, pipeline stages, agent events
• Object storage (S3-compatible) — raw build console logs

All data is encrypted at rest and in transit. Each organization's database is fully isolated.

Multiple Jenkins controllers

Connect as many Jenkins controllers as you like. Each uses the same API key but a different Server Name. All servers appear in a unified dashboard with per-server filtering.

Network requirements

Your Jenkins instance needs outbound HTTPS access to:

• api.buildbutler.dev — build data ingestion
• logs.buildbutler.dev — log upload (object storage)

If Jenkins is behind a proxy, set the proxy in Manage Jenkins → Proxy Configuration.

Troubleshooting