create-threadlens-app
v0.10.0
Published
One-command local-first ThreadLens self-host installer
Readme
create-threadlens-app
One-command local-first ThreadLens self-host installer.
Requirements
- Node.js 20+
- Docker and Docker Compose (Docker Desktop or Docker Engine with the Compose plugin)
Usage
npx create-threadlens-app@latestThis command creates an isolated local app directory, starts ThreadLens with Docker Compose, runs readiness checks, and opens the setup wizard. No global install required.
What it sets up
- A local directory with a
docker-compose.ymland.envconfig file - ThreadLens running via Docker (Go API + Svelte web app)
- All data stored in a local SQLite volume under your control
Commands
Once installed, manage your ThreadLens instance from the app directory:
| Command | What it does |
| ------- | ------------ |
| threadlens start | Start the ThreadLens Docker containers |
| threadlens stop | Stop the containers (data is preserved) |
| threadlens status | Show container status and the local app URL |
| threadlens logs | Stream live container logs |
| threadlens doctor | Run readiness checks and diagnose common problems |
| threadlens upgrade | Pull the latest ThreadLens image and restart |
| threadlens reset | Stop containers and remove local data volumes |
Documentation
Full documentation at docs.threadlens.dev.
Source
The open-core source is at github.com/threadlenshq/threadlens.
Releases
ThreadLens releases are unified: create-threadlens-app (npm) and open-core (public GitHub) share the same version number and are published together under a single threadlens-vVERSION tag.
To preview what a release would do without writing anything:
node scripts/release/index.js --dry-runTo prepare a new release, run from the monorepo root:
node scripts/release/index.js --prepareLicense
BUSL-1.1 — see the ThreadLens license page for details on what self-hosted use is permitted.
