Skip to Content
Self HostingPrerequisites

Prerequisites

Hardware

RequirementMinimumRecommended
Architecturex86_64x86_64
CPU4 cores, KVM-capable8+ cores
RAM8 GB16+ GB
Disk100 GB250+ GB SSD
KVM supportRequiredRequired

Verify KVM support:

# Should return > 0
egrep -c '(vmx|svm)' /proc/cpuinfo
 
# Should show kvm module loaded
lsmod | grep kvm

Operating System

Linux with KVM/libvirt support. Tested distributions:

  • Debian 12 (Bookworm) or Debian 13 (Trixie) — recommended
  • Ubuntu 22.04 LTS or 24.04 LTS
  • Fedora 40+

Software

SoftwareVersionPurpose
Python3.10+Backend services
Node.js18+Frontend (Next.js)
Git2.xBuild system, repo management
libvirt9.0+VM management
QEMU/KVM7.0+Virtual machine hypervisor
live-build1:20230502+Debian ISO build tool
Claude Code CLILatestAI build configuration agent

External Services

Required

  • Anthropic API key — The backend uses the Claude Code CLI (claude-agent-sdk), which requires a valid ANTHROPIC_API_KEY in the environment. This powers the AI build configuration agent.
  • SSH keys for build-iso repos — The build worker clones build-iso-public and build-iso-ubuntu repositories via SSH. You need deploy keys or SSH credentials with read access.

Optional

ServicePurpose
Google OAuth credentialsUser sign-in via Google
GitHub OAuth credentialsGitHub integration
OBS (Open Build Service)Building Elster OS / Vyatta packages
openQAExtended automated test execution
SMTP serverEmail notifications

Next Steps

Once you have all prerequisites in place, proceed to Installation.

InstallationProduction Deployment