Quick Start (Docker)
Prerequisites
Section titled “Prerequisites”- Docker with Compose
git
Nothing else needs to be installed on the host. The Dockerfile builds with node:22-alpine internally.
1. Clone the repo
Section titled “1. Clone the repo”git clone https://github.com/smithadifd/starting-six.gitcd starting-six2. Set environment variables
Section titled “2. Set environment variables”cp .env.example .env.localOpen .env.local and set BETTER_AUTH_SECRET. Compose will refuse to start without it. Generate one with:
openssl rand -base64 32The other values in .env.example (DATABASE_URL, BETTER_AUTH_URL, APP_URL, NEXT_PUBLIC_APP_URL) have sensible defaults for local use.
3. Start the container
Section titled “3. Start the container”docker compose up -dThe app service binds to host port 3000 (mapped to 3000 inside the container) and persists SQLite data to ./data on the host.
4. First-run setup
Section titled “4. First-run setup”- Open
http://localhost:3000in a browser. - Create your first account at
/setup. - Go to
/settings/systemand trigger the PokeAPI sync.
The initial sync pulls ~1,000 Pokemon plus moves and abilities and takes roughly 15-25 minutes. Progress streams live over SSE. See First Run & PokeAPI Sync for what to expect stage by stage.
Updating
Section titled “Updating”git pulldocker compose up -d --build