System Requirements

Hardware and software requirements for running ButterStack.

ButterStack Cloud

The ButterStack web application runs in your browser with no local installation required.

Browser Support

Browser	Minimum Version
Chrome	90+
Firefox	88+
Safari	14+
Edge	90+

Network Requirements

Stable internet connection
HTTPS access to *.butterstack.com
WebSocket support for real-time updates

Build Agents

If running self-hosted build agents, the following requirements apply.

Operating Systems

OS	Minimum Version
Windows	Windows 10 / Server 2019
Linux	Ubuntu 20.04, CentOS 8, or equivalent
macOS	macOS 11 (Big Sur)

Hardware Requirements

Minimum Specifications

Component	Requirement
CPU	4 cores
RAM	8 GB
Storage	100 GB SSD
Network	100 Mbps

Recommended Specifications

Component	Requirement
CPU	8+ cores
RAM	32 GB
Storage	500 GB NVMe SSD
Network	1 Gbps

Game Engine Requirements

Unreal Engine

Unreal Engine 4.27+ or 5.x
Visual Studio 2019/2022 (Windows)
Xcode 14+ (macOS)
Engine must be source-built for some features

Unity

Unity 2021.3 LTS or newer
Unity Build Server license (for CI/CD)

Integration Requirements

Perforce

Helix Core Server 2019.1+
Helix Command-Line Client (P4)
Network access from ButterStack to Perforce server

Jenkins

Jenkins 2.346+
A Jenkins user with an API token (ButterStack triggers jobs through Jenkins’ own REST API - no Generic Webhook Trigger plugin is required)
Network access from ButterStack to Jenkins, and from Jenkins back out to ButterStack for build-status callbacks
For the callback leg: the HTTP Request plugin, or curl in a post-build step. See the Jenkins integration guide.

Jira

Jira Cloud or Jira Server 8.0+
API access enabled
Admin permissions for webhook configuration

Network Configuration

Firewall Rules

Allow outbound HTTPS (443) to:

www.butterstack.com

That single host serves the app, the docs, the JSON API (/api/v1/...) and every inbound webhook endpoint. There is no separate app., api. or webhooks. subdomain.

Webhook Endpoints

If your tools need to send webhooks to ButterStack, ensure they can reach these endpoints:

Integration	Webhook URL
Jenkins / other CI	`https://www.butterstack.com/webhooks/jenkins?token={webhook_token}` (alias: `/webhooks/ci`)
Buildkite	`https://www.butterstack.com/webhooks/buildkite?token={webhook_token}`
Perforce	`https://www.butterstack.com/webhooks/perforce?token={webhook_token}`
Jira	`https://www.butterstack.com/webhooks/jira?token={webhook_token}`
Linear	`https://www.butterstack.com/webhooks/linear?token={webhook_token}`
GitHub	`https://www.butterstack.com/webhooks/github?token={webhook_token}`
Lore	`https://www.butterstack.com/webhooks/lore?token={webhook_token}`
Diversion	`https://www.butterstack.com/webhooks/diversion?token={webhook_token}`
Game Engine	`https://www.butterstack.com/webhooks/game_engine/{event}`
Deployment	`https://www.butterstack.com/webhooks/deployment?token={webhook_token}`

There is no {project_id} path segment. The webhook token identifies the integration, and therefore the project. Copy the exact URL from the integration’s page in ButterStack rather than assembling it by hand; see the Webhooks reference for the full endpoint list, the header-based token alternatives, and response codes.

IP Allowlisting

Contact support for static IP ranges if you need to allowlist ButterStack IPs in your firewall.

Storage Requirements

Build Artifacts

ButterStack does not store your build artifacts - it records their names, sizes and locations, and links to them in your CI system. Plan artifact storage capacity in Jenkins / GitHub Actions / your artifact store, not here:

Build Size	Daily Builds	Monthly Storage (in your CI)
1 GB	5	~150 GB
5 GB	5	~750 GB
10 GB	10	~3 TB

Data Retention in ButterStack

Pipeline metadata retention is set by your plan, not by a per-project setting:

Plan	Metadata retention
Indie	7 days
Team	14 days
Studio	30 days
Enterprise	90 days

Quick Setup - Get started in 15 minutes
Account Setup - Create your account
Troubleshooting - Common issues and solutions

Next → Quick Setup