Getting Started

The shortest supported path from a new macOS or Linux host to a working Oblive organization.

This guide installs the complete local, self-hosted stack from one coordinated semantic release. No source checkout, Bun installation, or hand-written Compose file is required.

The Path

Check the host

Use macOS or Linux with Docker Compose. Choose either a local Codex login or an OpenAI API key. The installer can offer supported prerequisite installation paths.

Install one release

Run the hosted installer. Choose the stable latest channel or pin a selected vX.Y.Z release.

Review configuration

The installer creates strong local secrets, a minimal local-stack.json, and its adjacent JSON Schema. Add only the integrations and public callback URLs you need.

Start and verify

Start infrastructure, migrations, backend, frontend, chat, and workers together. Verify health before creating an organization.

Quick Start

curl -fsSL https://oblive.dev/install.sh | sh

Open http://127.0.0.1:3001 after the installer reports that Oblive is ready.

The installer stores the exact resolved release. oblive start never changes versions; oblive update is the explicit update boundary.