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+
- Generic Webhook Trigger plugin
- Network access from Jenkins to ButterStack webhooks
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:
app.butterstack.com
api.butterstack.com
webhooks.butterstack.com
Webhook Endpoints
If your tools need to send webhooks to ButterStack, ensure they can reach these endpoints:
| Integration | Webhook URL |
|---|---|
| Jenkins | https://app.butterstack.com/webhooks/jenkins/{project_id} |
| Perforce | https://app.butterstack.com/webhooks/perforce/{project_id} |
| Jira | https://app.butterstack.com/webhooks/jira/{project_id} |
| Linear | https://app.butterstack.com/webhooks/linear/{project_id} |
| Git | https://app.butterstack.com/webhooks/git/{project_id} |
| Diversion | https://app.butterstack.com/webhooks/diversion/{project_id} |
| Game Engine | https://app.butterstack.com/webhooks/game_engine/{project_id} |
| Deployment | https://app.butterstack.com/webhooks/deployment/{project_id} |
Replace {project_id} with your ButterStack project ID.
IP Allowlisting
Contact support for static IP ranges if you need to allowlist ButterStack IPs in your firewall.
Storage Requirements
Build Artifacts
Plan for artifact storage based on your build frequency:
| Build Size | Daily Builds | Monthly Storage |
|---|---|---|
| 1 GB | 5 | ~150 GB |
| 5 GB | 5 | ~750 GB |
| 10 GB | 10 | ~3 TB |
Artifacts are stored for 30 days by default. Configure retention policies in project settings.
Related
- Quick Setup - Get started in 15 minutes
- Account Setup - Create your account
- Troubleshooting - Common issues and solutions