The installer handles everything automatically — it detects your OS, installs PostgreSQL if needed, downloads the Qorven binary, generates encryption keys, sets up HTTPS, and registers a system service. No manual configuration required.

​
What you need

Minimum:
  • A 64-bit Linux or macOS machine (x86_64 or arm64)
  • Root access (sudo) — the installer writes to /usr/local/bin and creates a system user
  • ~2 GB RAM, ~5 GB disk, outbound internet access
Recommended for teams:
  • 4 GB RAM or more
  • A domain name if you want a valid HTTPS certificate (optional — a local CA works fine)

​
Quick install

curl -fsSL https://get.qorven.ai | sudo bash
What the installer does:
1

Detects your OS

Identifies your package manager (apt, dnf, pacman, brew, or apk) and prints exactly what it’s about to do.
2

Installs PostgreSQL

Only if PostgreSQL isn’t already installed. Uses the native package manager — nothing unexpected.
3

Creates a system user

Adds a locked-down qorven user with no shell or password. All data is stored under /var/lib/qorven.
4

Downloads the binary

Pulls the correct qorven binary for your OS and architecture from GitHub Releases and verifies its SHA-256 checksum.
5

Generates config and secrets

Writes /etc/qorven/config.toml with a fresh encryption key and an auth token. These are unique to your install.
6

Sets up HTTPS

Generates a local TLS certificate and installs a local CA so your browser shows a green lock on first visit.
7

Registers a system service

Creates a hardened systemd unit, enables it, and starts Qorven immediately.
8

Opens the browser

Waits for the health check, then prints the URL and your admin token so you can log in right away.

​
Verify the install

sudo systemctl status qorven    # should show: active (running)
sudo qorven doctor              # runs health checks on all components
curl -k https://localhost/health # → {"status":"ok","version":"..."}

​
What was written to disk

/usr/local/bin/qorven                  # the main binary
/etc/qorven/config.toml                # your configuration (keep this backed up)
/etc/qorven/tls/                       # HTTPS certificate and private key
/var/lib/qorven/                       # all data (sessions, agent memory, uploads)
/etc/systemd/system/qorven.service     # the system service unit
During install, two 256-bit secrets are generated from /dev/urandom:
  • auth_token — used to authenticate API requests and log into the web UI
  • encryption_key — protects your AI provider keys, OAuth tokens, and other secrets stored in the database
The encryption key is stored only in /etc/qorven/config.toml. If you lose it, any encrypted data in the database cannot be recovered. Back up this file.

​
Uninstall

curl -fsSL https://get.qorven.ai | sudo bash -s -- --uninstall
This removes the binary, config, and service. Your database is left intact — drop it manually when you’re ready: 
sudo -u postgres psql -c "DROP DATABASE qorven; DROP USER qorven;"
sudo rm -rf /var/lib/qorven /var/log/qorven

​
Where next

First chat

Open Qorven in your browser and say hello to Prime.

Setup wizard

Prefer the terminal? qorven setup walks the same flow.

Add an AI provider

Connect your OpenAI, Anthropic, or other API key.

Configure HTTPS

Install the local CA on other devices that will access Qorven.