Testnet · chain 6
Open app
  1. Docs
  2. Get started
  3. Run locally

Get started

Run locally

Start the full Trust Stack stack and its self-hosted handbook.

Revision 61 min read
On this page
  1. Prerequisites
  2. Install and start frontends
  3. Start the service stack
  4. Verify before changing behavior
  5. Environment boundaries

The monorepo contains the dApp, marketing and public-proof site, Go indexer API, PostgreSQL-backed local services, TypeScript packages, Move packages, and this documentation portal.

Prerequisites#

  • Node.js and pnpm versions compatible with the repository lockfile
  • Docker Desktop or another Docker-compatible engine
  • Go for direct indexer development
  • the pinned Supra validator image for deterministic Move tests

Install and start frontends#

From the repository root:

Bash
pnpm install --frozen-lockfile
pnpm --filter @workspace/marketing dev
pnpm --filter @workspace/dapp dev
pnpm --filter @workspace/docs dev

The default local URLs are:

ServiceURL
Marketing and public proofshttp://localhost:3000
Trust Stack dApphttp://localhost:3001
Documentationhttp://localhost:3002
Indexer API healthhttp://localhost:8080/healthz

Start the service stack#

Use the repository's local Docker Compose configuration for PostgreSQL and the indexer API. Keep credentials in local environment files; do not commit them. Confirm both /healthz and /readyz before using indexed pages.

If port 3000 is already reserved, select a different marketing port for both the published service and the dApp's public-proof link:

Bash
MARKETING_PORT=3010 docker compose --profile indexer up -d --build

Verify before changing behavior#

Bash
pnpm check
pnpm test
pnpm test:e2e

Run Move tests with the exact image and framework pin recorded in move/trust-stack/README.md. The command there mounts only the Move package, runs the Supra CLI in the container, and produces instruction coverage.

Environment boundaries#

  • NEXT_PUBLIC_API_BASE_URL selects the read-only indexer origin.
  • NEXT_PUBLIC_DAPP_URL links marketing and docs to the dApp.
  • NEXT_PUBLIC_MARKETING_URL links the dApp back to public proofs.
  • NEXT_PUBLIC_DOCS_URL links the dApp to this handbook.
  • wallet writes still target the typed, checked-in chain ID and package addresses.

Do not point a local browser at mainnet simply by changing an environment variable. Network and deployment promotion require an explicit release and audit decision.