Self-hosted Setup

Run ADHDev locally without any cloud dependency.

Quick Start

npx @adhdev/daemon-standalone

Open http://localhost:3847 — done!

From Source

# Clone the OSS repository
git clone https://github.com/vilmire/adhdev.git
cd adhdev

# Install dependencies
npm install

# Build all packages
npm run build

# Start standalone daemon + dashboard
npm run dev

Options

Flag	Default	Description
--port	3847	HTTP server port
--host	localhost	Bind address (0.0.0.0 for LAN access)
--token	none	Require token for authentication
--no-open	false	Don't auto-open browser

Example Configurations

# LAN access (other devices on same network)
npx @adhdev/daemon-standalone --host 0.0.0.0

# Custom port with auth
npx @adhdev/daemon-standalone --port 8080 --token mysecret123

# Access from phone on same Wi-Fi
# On your phone's browser: http://192.168.1.100:3847
npx @adhdev/daemon-standalone --host

Architecture

┌──────────────────────────────────┐
│  Your Machine                    │
│  ┌──────────┐  ┌──────────────┐ │    ┌──────────┐
│  │ IDE      │  │ Standalone   │ │    │ Browser  │
│  │ + AI Ext │──│ Daemon       │─┼────│ Dashboard│
│  └──────────┘  │ HTTP + WS    │ │    └──────────┘
│                └──────────────┘ │
└──────────────────────────────────┘
     Everything runs locally

Differences from Cloud

Feature	Self-hosted	Cloud
Remote access (outside LAN)	❌	✅
Multi-machine	❌	✅
OAuth login	❌	✅
P2P encryption	N/A (local)	✅
Push notifications	❌	✅
REST API	✅ (local)	✅ (cloud)
Price	Free	Free + paid

Next Steps

• Configuration →
• Local API →