Skip to Content
Pyxis Docs

Configuration

Environment variables for running Pyxis.

VariableUsed byDefaultPurpose
DATABASE_URLapp runtimepostgres://pyxis_app:pyxis_app@localhost:54329/pyxisConnection for the non-owner runtime role pyxis_app
ADMIN_DATABASE_URLdb:migrate, db:rolepostgres://postgres:postgres@localhost:54329/pyxis (migrate only)Owner connection used to run migrations
PYXIS_APP_PASSWORDdb:rolenone (required there)Replaces the development password of pyxis_app after migrating
OPERATOR_ACCOUNTSapp runtimeemptyStellar public keys that get the operator role at sign-in
UMAMI_URLapp runtimenoneBase URL of the Umami instance; web analytics is off without it
UMAMI_USER, UMAMI_PASSWORDapp runtimenoneCredentials for Umami's REST API
UMAMI_PUBLIC_URLapp runtimeUMAMI_URLOrigin the tracker snippet loads script.js from
BACKEND_URLnext dev / next buildnoneProxy API requests to a deployed backend
NEXT_DIST_DIRNext.js.nextSeparate build directory

Scripts

CommandWhat it does
npm run devNext.js dev server
npm run build / npm startProduction build and server
npm run typecheckGenerate route types and run tsc --noEmit
npm testVitest (starts its own embedded PostgreSQL)
npm run db:devEmbedded PostgreSQL on :54329, migrations applied
npm run db:migrateApply db/migrations/*.sql (checksummed, transactional)
npm run db:roleSet the pyxis_app password from PYXIS_APP_PASSWORD
npm run seedLoad synthetic demo data and print ingest keys

On this page