Run ThreadLens with Docker
Run ThreadLens with Docker
Section titled “Run ThreadLens with Docker”Use this path when you want the fastest local ThreadLens setup. Commands in this page run from the open-core/ directory.
Prerequisites
Section titled “Prerequisites”- Node and pnpm compatible with
packageManager: pnpm@10.14.0. - Docker Desktop or another Docker Engine with Compose support.
- Provider keys if you want AI analysis, Google scouting, or Bluesky scouting.
Start the development profile
Section titled “Start the development profile”pnpm installpnpm run docker:devExpected local services:
| Service | URL | Notes |
|---|---|---|
| Go API | http://localhost:4749 | Uses SQLite stored in the scout_open_core_sqlite_data Docker volume. |
| Web app | http://localhost:4748 | Vite dev server proxies /api requests to the Go API container. |
Verify the app is reachable
Section titled “Verify the app is reachable”Open http://localhost:4748 in a browser. The app should load the ThreadLens interface and call the API through the Vite proxy.
You can also check the API directly:
curl -i http://localhost:4749/api/runtime/capabilitiesExpected result: an HTTP 200 response with JSON runtime information.
Start the production self-host profile
Section titled “Start the production self-host profile”pnpm run docker:prodThe production profile serves the built web app from the Go API container at http://localhost:4749.
Stop Docker services
Section titled “Stop Docker services”pnpm run docker:downThis stops supported dev and prod profiles without deleting the SQLite data volume.