Install Zveltio

1

One-Click Install (auto-detects mode)

No prerequisites needed. The installer detects your environment and picks the best mode automatically.

curl -fsSL https://get.zveltio.com/install.sh | sudo bash

Auto-detect order: Bun present → native | Docker present → Docker | nothing → installs Bun, then native.

2a

Native Mode (recommended — no Docker needed)

Installs PostgreSQL 18 + pgvector, Valkey, SeaweedFS, and the Zveltio engine directly on the server. All services managed via systemd. Lower RAM usage, better for production VPS.

curl -fsSL https://get.zveltio.com/install.sh | sudo bash -s -- --mode native

Ubuntu 22.04+ or Debian 11/12
Minimum 2 GB RAM, 20 GB disk
Root / sudo access

2b

Docker Mode (containers)

Runs the full stack in Docker containers. Useful for local development, WSL, or environments where Docker is already present.

curl -fsSL https://get.zveltio.com/install.sh | sudo bash -s -- --mode docker

Docker + Docker Compose v2 Install →
Minimum 2 GB RAM (3 GB recommended for Docker overhead)

2c

Proxmox LXC (run on Proxmox host)

Creates a Debian 12 LXC container and installs Zveltio natively inside it. Interactive — asks for RAM, disk, CPU, bridge.

bash -c "$(curl -fsSL https://raw.githubusercontent.com/zveltio-devs/zveltio/master/install/proxmox-lxc.sh)"

3

Advanced Options

Specific version

curl -fsSL https://get.zveltio.com/install.sh | sudo bash -s -- --version …

Custom install directory

curl -fsSL https://get.zveltio.com/install.sh | sudo bash -s -- --dir /opt/zveltio

Non-interactive / CI

curl -fsSL https://get.zveltio.com/install.sh | sudo bash -s -- --unattended

Engine only (bring your own DB / Valkey / S3)

curl -fsSL https://get.zveltio.com/install.sh | sudo bash -s -- --mode docker --skip-infra

Manual Docker Compose

curl -fsSL https://get.zveltio.com/releases/latest/docker-compose.yml -o docker-compose.yml
curl -fsSL https://get.zveltio.com/releases/latest/.env.example -o .env
# Edit .env, then:
docker compose up -d

Open Compose Builder →

4

Updating

sudo bash /opt/zveltio/update.sh

Docker: docker compose pull && docker compose up -d