Installation

System requirements

Item	Minimum	Recommended
CPU	2 cores	4+ cores
RAM	4GB	8GB+
Storage	20GB	100GB SSD
OS	Ubuntu 22.04+	Ubuntu 24.04

Install

Script (recommended)

curl -fsSL https://get.gumball.dev/install.sh | sudo sh

Manual

# 1. Download
wget https://github.com/onescluster/capsuled/releases/latest/download/gumball-linux-amd64.tar.gz

# 2. Extract
tar -xzf gumball-linux-amd64.tar.gz

# 3. Move into PATH
sudo mv gumball /usr/local/bin/

# 4. Install as a service
sudo gumball service install
sudo systemctl enable --now gumball

Initial setup

gumball init

Verify

gumball status