ClaireDocs

Type to search titles, headings, and full text.

    Ask Claire

    Search the project, not the web.

    Answers are grounded in Claire’s published documentation and include the source pages used.

    ⌘/Ctrl + J opens Ask Claire anywhere in docs.

    Self-hosting

    Run Claire on your own infrastructure without publishing operator secrets.

    CurrentReviewed 2026-08-15View source ↗

    Claire is designed to be self-hostable end to end: the API, Postgres, Redis, the Matrix homeserver, and the bridges all run from this repository’s compose files.

    The short version#

    1. Create your environment file

      Copy server/.env.example and set your own values. Nothing in this repository contains working credentials.

    2. Start the stacks

      Terminal
      bun run docker:up

      Or run the compose files directly if you are deploying them to separate hosts.

    3. Apply the database migrations

      Everything in supabase/migrations/, in filename order.

    4. Point the clients at your API origin

      Mobile and desktop read the origin from their environment; nothing is hardcoded.

    What the public docs deliberately omit#

    Then go deeper#

    Production setupHardening, migrations, and the checks worth running before you take traffic.Deploy to RailwayA worked example of a managed deployment.