Prerequisites

Required tools and system requirements

Required Tools

ToolVersionInstallation
VirtualBox7.0+Download
Vagrant2.4+Download
kubectl1.34+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
Storage2 GB110 GBNFS Server + HashiCorp Vault
ControlPlane6 GB420 GBK8s Master + Monitoring
Node018 GB220 GBWorker + AI Workloads
Node024 GB220 GBWorker
Total20 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
Storage2 GB110 GB
ControlPlane4 GB220 GB
Node014 GB220 GB
Node024 GB220 GB
Total14 GB770 GB