Skip to Content
QuasarSelf-Hosting

Self-Hosting

Quasar Community Edition is Quasar under the Apache-2.0 license, published at TuwaIO/quasar-community  with Docker images on GHCR. It runs the same tracking engine and the same API as Quasar Cloud, for one operator: see Quasar Cloud and Quasar Community for what it leaves out.

The setup is documented in the repository; this page only links to it:

GuideCovers
README What the edition includes, the repository layout, a five-minute quick start and the workspace limits
Local quick start Environment variables, the single-node Docker Compose profile, seeding and the first login
Production deployment The high-availability profile: Postgres primary and standby, Redis cluster, PgBouncer, WAL-G, Traefik
CI/CD setup Deploying your fork with the included GitHub Actions workflow
Seeding What the seed creates and how to run it again

A public preview built from the same tree runs at community-stg.tuwa.io ; it follows development and is not a service to rely on.


🔌 Point the SDK at Your Node

Everything else stays the same: create an app in the /admin panel of your node, copy its secret key, and pass the URL of your API:

src/lib/quasar.ts
import { Quasar } from '@tuwaio/quasar-sdk'; export const quasar = new Quasar({ secretKey: process.env.QUASAR_SECRET_KEY ?? '', baseUrl: process.env.QUASAR_BASE_URL ?? 'https://api.tuwa.io', });

Pass the same URL to preFlightTxCheck(url) from @tuwaio/quasar-sdk/react in the browser, and to the webhook relay with npx @tuwaio/quasar-sdk listen --api-url <url> (or QUASAR_BASE_URL in .env).

There is no export of the history from Quasar Cloud to a self-hosted node yet: after the switch, the history of the app starts on your node.

Last updated on