Get started

Get started

Self-host QuoxCORE, or let Claude set it up.

QuoxCORE runs from Docker Compose on your own hardware. If you would rather not run the commands yourself, point Claude Code at Quoxpert and it stands the stack up for you.

Core platform FreeInstall Docker ComposeFirst admin Setup Wizard

In plain words

What it is, where it lives, when to reach for it

What is it
The install guide for QuoxCORE, the self-hosted platform, from a bare host to first login.
Where do I use it
On a Linux server or VM you own, with Docker and the Compose plugin.
When would I use it
When you are ready to run the platform on your own hardware.
How do I use it
Early access until launch: sign git in to GitHub, then run curl -fsSL https://get.quox.ai | sh.

QuoxCORE is the free, self-hosted platform underneath this. What is QuoxCORE

Quick self-host path

Install with Docker Compose.

The script below clones the source and runs the stack's own setup, unattended, on your own machine. It is not a shortcut that hides what happens: every step it takes is listed below, and you can fetch the script and read it before piping it to a shell.

Orchestration, agents, memory and governed tools, live in a few real commands, not a black box.

Self-host, scripted
$curl -fsSL https://get.quox.ai | sh

Needs Git, Docker Compose and a Linux or macOS host.

clones the public quoxcore and quoxmcp repos (QuoxFlow is bundled), then runs quoxcore's scripts/setup.sh --yes (generates secrets, builds and starts the stack) · your keys, your data · no card to start

What that command actually does

Two real steps. No magic.

QuoxCORE installs with Docker Compose, not a single opaque binary. The installer clones the public quoxcore and quoxmcp repos side by side (QuoxFlow is bundled in quoxcore), then runs scripts/setup.sh --yes, which generates secrets and SSL certs, builds the images and starts the stack. Both repos are public, so no GitHub sign-in is needed.

$curl -fsSL https://get.quox.ai | sh

Needs Git, Docker Compose and a Linux or macOS host.

Apache 2.0 protocols · Quox Community Source Licence 1.0 source-available core

Why two sibling reposquoxmcp is a mandatory checkout, cloned as a sibling of quox, not a subfolder of it. Without it, MCP tools are not available to agents. QuoxFlow is bundled inside quoxcore at quoxflow/, so it needs no separate clone. The installer gets both repos.

Once the containers report healthy, open https://localhost:3000 and complete the Setup Wizard. That is how the first admin account and organisation get created: there is no seed script to run in production, by design.

Deploying on a public, internet-facing boxAdd the hardened compose override so the containers never mount the Docker socket or your home directory:docker compose -f docker-compose.yml -f docker-compose.public.yml up -d. The full deploy guide covers TLS, firewalling and backups.

Before you start

What you need.

Any Linux box that runs current Docker will do. Nothing exotic.

Docker 20.10 or later, with the Compose plugin. Run docker compose version to check.
Docker Compose v2.0 or later. Ships with current Docker Desktop and the Docker Engine Compose plugin.
git and Docker (Compose v2). The installer clones two public repos, quoxai/quoxcore and quoxai/quoxmcp.
Resources 2+ CPU cores, 4GB+ RAM (8GB+ recommended), 10GB+ disk.
OS Linux: Ubuntu 20.04+, Debian 11+, RHEL/CentOS Stream 8+, Fedora 38+, Alpine 3.18+, or Arch.
Network outbound access to pull images and, for chat, an Anthropic or OpenAI API key (or Claude CLI OAuth).

Or let Claude set it up

Claude-managed setup.

Point Claude Code at Quoxpert and it installs, configures and runs QuoxCORE for you. Quoxpert makes your Claude an instant expert at Quox: it drives the quox CLI and the Quox MCP tools to stand up the stack, complete the Setup Wizard, and operate it day to day, governed and logged like everything else on the platform.

Early accessv0.1Licence at release
How to get Quoxpert

Quoxpert ships with early access until launch. Early-access customers get the Claude Code plugin and its installer alongside repository access. Get early access.