Configuration
Environment variables, database, and runtime settings.
Environment Variables
All configuration is via environment variables (.env):
| Variable | Default | Description |
|---|---|---|
PORT | 3000 | Server port |
DATABASE_PATH | ./data/linkbreeze.db | SQLite database file path |
SECRET_KEY | Auto-generated | HMAC signing key for sessions |
Runtime settings (page slug, title, SEO, theme) are managed via the admin dashboard and stored in the database — no code changes needed.
Database
LinkBreeze uses SQLite (via better-sqlite3 in WAL mode). The database file is stored at DATABASE_PATH. No external database server needed.
For Docker deployments, the database lives inside the linkbreeze-data volume at /app/data/linkbreeze.db.
Analytics
Privacy-first analytics are built in. No configuration needed.
- Page views tracked per page
- Click tracking per link
- Device, referrer data collected
- No cookies, no third-party scripts
- Data stored locally in your SQLite database
External Analytics
Want to add Plausible, Umami, Matomo, or Google Analytics? Paste your tracking snippet in Admin > Settings > External Analytics. It gets injected into your public page <head> with zero client-side bundle impact.
Backup and Restore
Export your entire setup from Admin > Settings > Backup.
- Exports as JSON
- Includes all pages, links, themes, settings
- Import on any LinkBreeze instance