Docker

This guide runs HappyView and the dashboard locally using Docker Compose.

Prerequisites

• Docker and Docker Compose

1. Clone and configure

git clone git@tangled.org:gamesgamesgamesgames.games/happyview
cd happyview
cp .env.example .env

Edit .env and set at least PUBLIC_URL (e.g. http://127.0.0.1:3000) and SESSION_SECRET (at least 64 characters). The defaults work for everything else. See Configuration for the full list of environment variables.

2. Start the stack

docker compose up

This starts:

HappyView runs migrations automatically on startup. The first build will take a few minutes while Rust compiles.

The happyview container serves its own bundled dashboard at http://127.0.0.1:3000, but that copy is baked in at container build time and only updates when you rebuild the image. For day-to-day development, use the dev dashboard at http://127.0.0.1:3001 — it hot-reloads on changes to the web/ source.

Next steps

Your HappyView stack is running. Follow the Statusphere tutorial to upload lexicons, add custom query logic, and start indexing records from the network.