Prerequisites

Required tools and system requirements

Required Tools

ToolVersionInstallation
VirtualBox7.0+Download
Vagrant2.4+Download
kubectl1.32+Install Guide
Go1.22+Download (only for building)

Installation by OS

macOS (Homebrew)

brew install --cask virtualbox vagrant
brew install kubectl go

Ubuntu/Debian

# VirtualBox
sudo apt install virtualbox

# Vagrant
wget https://releases.hashicorp.com/vagrant/2.4.3/vagrant_2.4.3-1_amd64.deb
sudo dpkg -i vagrant_2.4.3-1_amd64.deb

# kubectl
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
sudo install kubectl /usr/local/bin/

# Go
sudo snap install go --classic

Windows

Use Chocolatey:

choco install virtualbox vagrant kubernetes-cli golang

System Requirements

ResourceMinimumRecommended
RAM20 GB32 GB
CPU8 cores12 cores
Disk50 GB free100 GB free

VM Resource Allocation (Full Stack with AI)

VMMemoryCPUsDiskPurpose
Storage1 GB110 GBNFS Server
ControlPlane6 GB420 GBK8s Master + Monitoring
Node018 GB220 GBWorker + AI Workloads
Node024 GB220 GBWorker
Total19 GB970 GB

Note: Node01 has extra memory for Ollama AI workloads (llama3.2:3b requires ~4GB).

VM Resource Allocation (Without AI)

If you disable Karpor AI (karpor_ai.enabled: false), you can use reduced resources:

VMMemoryCPUsDisk
Storage1 GB110 GB
ControlPlane4 GB220 GB
Node014 GB220 GB
Node024 GB220 GB
Total13 GB770 GB