Deployment

Choose your path.

Deploy FreeAI anywhere โ€” bare metal, Docker, cloud GPUs, or Kubernetes. Same stack, different runtime.

๐Ÿง

Bare Metal

Full control. Auto-detects GPU, installs drivers, CUDA, Docker, and the complete stack.

git clone https://github.com/ProjectZeroDays/FreeAI_AI-Inference-Workstation.git
cd FreeAI_AI-Inference-Workstation
sudo ./hardware/install-stack.sh
bash models/auto-download-models.sh
๐Ÿณ

Docker Compose

Any host with NVIDIA Docker. Split or all-in-one profiles.

git clone https://github.com/ProjectZeroDays/FreeAI_AI-Inference-Workstation.git
cd FreeAI_AI-Inference-Workstation
docker compose --profile allinone up -d
# Dashboard: http://localhost:8030
โ˜๏ธ

Cloud & Live ISO

Kubernetes manifests, Vast.ai templates, RunPod kits, Hetzner bare-metal. Also bootable as a Live ISO.

docker pull ghcr.io/freeai/freeai:latest
# or boot freeaios-amd64.iso
Cloud Providers

Deploy on any cloud

๐Ÿง€

Salad GPU

  • Sign up at salad.com
  • Select GPU instance type
  • Use image: ghcr.io/freeai/freeai:latest
  • Configure GPU profile in config/providers.json
๐Ÿš€

Vast.ai

  • Browse GPUs at vast.ai
  • Select CUDA-capable instance
  • Deploy using vastai/ template
  • Auto-provisions FreeAI on first boot
โšก

RunPod

  • Create pod at runpod.io
  • Use FreeAI template or custom Docker image
  • GPU-powered inference ready in minutes
๐Ÿ–ฅ

Hostinger VPS

  • Deploy Ubuntu 24.04 VPS
  • SSH into server
  • Run ./install.sh
  • Configure reverse proxy in panel
๐Ÿ”ต

DigitalOcean

  • Create Ubuntu 24.04 droplet (8GB+ RAM)
  • Run installation script
  • Set up firewall rules
  • Configure DNS for custom domain
โŽˆ

Kubernetes

  • Apply k8s/freeai-deployment.yaml
  • Requires NVIDIA GPU operator
  • Auto-scaling with VPA/HPA
  • StatefulSet for model persistence
Services

Port reference

ServicePortDescription
Dashboard8030Web UI, all pages
Proxy8100Model routing proxy
Memory8110Embedding & recall store
Agents8120Agent orchestration
Registry8130Skill/MCP/plugin registry
RAG8140Retrieval-augmented generation
Brain8150Reasoning engine
Skills8160Skill API server
Pipeline8170Workflow engine
Browser8180Headless browser automation
Campaign8090Campaign manager
GPU8200GPU resource manager
Awesome Registry8210Plugin marketplace
Permissions8220RBAC & access control
Scheduler8230Cron & task scheduler
Health Monitor8240System health checks
Salad8250Salad GPU integration