Qredence Documentation

SQLite is fine for local use. Use PostgreSQL when you need durable, shared storage.

Prerequisites

A PostgreSQL database reachable from the Fleet host
Fleet RLM installed with uv sync --dev
Daytona and model credentials configured as in the quickstart

Point Fleet at PostgreSQL

Set FLEET_DATABASE_URL in .env. Fleet normalizes postgres:// and postgresql:// URLs to the postgresql+asyncpg:// driver.

.env

FLEET_DATABASE_URL=postgresql+asyncpg://fleet_app:<password>@<host>:5432/fleet?ssl=require

Apply migrations. Fleet never migrates on startup.

uv run python scripts/database.py upgrade

upgrade also accepts --database-url to override FLEET_DATABASE_URL for one run, and --env-file to load a different environment file.

Managed deployments that use the Lakebase preflight must connect as the fleet_app role with TLS (ssl=require, verify-ca, or verify-full).

Database commands

scripts/database.py provides four operations.

Command	Description
`upgrade`	Apply Alembic migrations to the configured database.
`import-sqlite`	Copy data from a file-backed SQLite database to PostgreSQL.
`preflight`	Run the sanitized Lakebase readiness preflight.
`certify-postgres`	Run the bounded PostgreSQL contention certification.

Move data from SQLite

import-sqlite reads both URLs from environment variables, creates a verified SQLite backup, and writes a receipt.

uv run python scripts/database.py import-sqlite \
  --source-url-env FLEET_SQLITE_URL \
  --target-url-env FLEET_DATABASE_URL \
  --backup ./backups/fleet.sqlite3 \
  --receipt ./backups/import-receipt.json \
  --maintenance-window

The backup path must not exist yet. Stop Fleet before you import.

Run the backend

uv run fleet web

Or run the ASGI app directly:

uv run fleet-rlm serve-api --host 127.0.0.1 --port 8000

The Fleet API has no caller authentication. Fleet refuses to bind to a non-loopback host unless you pass --allow-non-loopback-bind. Only do that behind a trusted network boundary or an authenticating proxy. See Security.

Health checks

Endpoint	Returns
`GET /health`	`200` with `status: "ok"`, the app name, and version whenever the process serves HTTP.
`GET /health/ready`	`200` with `status: "ready"` and `database` set to `ok` or `not_configured`. Returns `503` with `service_not_ready` until startup completes or when the database is unreachable.

Upgrade

Stop Fleet.
Pull the new release and run uv sync --dev.
Run uv run python scripts/database.py upgrade.
Rebuild Daytona snapshots if the release changes them. See Sandbox execution.
Start Fleet.

Fleet-RLM

Fleet Prime Agent

Fleet Pi

GEPA Omni

Qredence Skills

Fleet Reasoner

Qredence Plugins

Deploy with PostgreSQL

Prerequisites

Point Fleet at PostgreSQL

Database commands

Move data from SQLite

Run the backend

Health checks

Upgrade

​Prerequisites

​Point Fleet at PostgreSQL

​Database commands

​Move data from SQLite

​Run the backend

​Health checks

​Upgrade

Prerequisites

Point Fleet at PostgreSQL

Database commands

Move data from SQLite

Run the backend

Health checks

Upgrade