Self-Hosting Quick Start
Set up Devhelion Tutor for your team with complete privacy and control. All your AI analytics data stays on your own infrastructure.
What You'll Set Up
PostgreSQL for persistent storage (Supabase, NeonDB, or self-hosted)
Devhelion Tutor server running on your infrastructure
Each team member connects their CLI to your server
Phase 1: Admin Setup
One-time setup by the team admin or DevOps
Set Up Your Database
Devhelion requires a PostgreSQL database for persistent storage. Choose one of these options:
Option A: Supabase (Easiest)
- 1. Go to supabase.com and create a free account
- 2. Create a new project
- 3. Go to Settings → Database
- 4. Copy the Connection string (URI)
postgresql://postgres.[project-ref]:[password]@aws-0-[region].pooler.supabase.com:6543/postgresOption B: NeonDB (Serverless PostgreSQL)
- 1. Go to neon.tech and create an account
- 2. Create a new project
- 3. Copy the connection string from the dashboard
postgresql://[user]:[password]@[endpoint].neon.tech/neondb?sslmode=requireOption C: Self-Hosted PostgreSQL
Use your existing PostgreSQL server or deploy one with Docker:
docker run -d --name Devhelion-postgres \
-e POSTGRES_USER=Devhelion \
-e POSTGRES_PASSWORD=your-secure-password \
-e POSTGRES_DB=Devhelion_analytics \
-p 5432:5432 \
postgres:15Connection string: postgresql://Devhelion:your-secure-password@localhost:5432/Devhelion_analytics
📝 Save your DATABASE_URL - you'll need it in the next step. This is also the key you'll distribute to team members who want to view the dashboard.
Install & Start the Server
Install the Devhelion CLI on your server machine:
npx @_xDevhelion/cli@latestConfigure your database connection:
# Configure database (interactive)
Devhelion server config set
# Or set database directly:
Devhelion server config database "postgresql://user:pass@host:5432/Devhelion_analytics"
# Verify configuration
Devhelion server statusStart the server:
# Start the server
Devhelion server start
# Check status
Devhelion server status
# View logs
Devhelion server logs✅ Success! Your server is now running. Test it: curl http://localhost:8080/api/health
Make Server Accessible to Your Team
Your team members need to reach the server. Options:
Option A: Internal Network
If your team is on the same network, use the server's internal IP:
http://192.168.1.100:8080Option B: Public URL with HTTPS (Recommended)
Set up a reverse proxy (nginx, Caddy) with SSL for remote access:
https://Devhelion.your-company.comOption C: Cloud Deployment
Deploy on Railway, Render, Fly.io, or your cloud provider. Set the DATABASE_URL environment variable.
📝 Save your Server URL - this is what you'll share with team members.
Phase 2: Team Member Setup
Each team member follows these steps on their own machine
Install the Devhelion CLI
Each team member installs the CLI on their development machine:
npx @_xDevhelion/cli@latestRequirements: Node.js 16+ with npm/npx. Works on Linux, macOS, and Windows.
Connect to Your Team's Server
Configure the CLI to point to your team's self-hosted server:
# Interactive configuration
Devhelion config set
# When prompted, enter your team's server URL:
# Dashboard URL: https://Devhelion.ai (keep default)
# Tutor Server URL: https://Devhelion.your-company.com (YOUR server)
# Verify configuration
Devhelion config showAuthenticate via Devhelion.ai OAuth:
# Login (opens browser for OAuth)
Devhelion login
# Enable telemetry collection
Devhelion enable
# Check everything is connected
Devhelion status✅ Done! Your CLI is now sending telemetry to your team's self-hosted server. All data stays on your infrastructure.
Phase 3: Using the Dashboard
View your team's AI analytics
Access the Dashboard
Team members can view analytics via the Devhelion.ai dashboard, pointed at your self-hosted data:
- 1Go to Devhelion.ai and log in
- 2Navigate to Settings → Data
- 3Enter your team's Tutor Server URL (e.g.,
https://Devhelion.your-company.comfrom Step 3) - 4Click Test & Save
🔒 Privacy Guarantee
The tutor server URL is stored only in your browser's localStorage. Devhelion's servers never see or store your server connection details. The dashboard connects directly from your browser to your tutor server.
Share Server Access with Team
For team members to view the dashboard, share your tutor server URL:
Team Onboarding Checklist
Team Setup Instructions
-----------------------
1. Install CLI: npx @_xDevhelion/cli@latest
2. Configure server: Devhelion config set
When prompted, enter:
- Dashboard URL: https://Devhelion.ai (default)
- Tutor Server URL: https://Devhelion.your-company.com
3. Login: Devhelion login
4. Enable: Devhelion enable
5. Dashboard setup (for viewing analytics):
- Go to Devhelion.ai → Settings → Data
- Enter Tutor Server URL: https://Devhelion.your-company.com
- Click Test & SaveCopy this to your team's internal wiki or Slack channel.
⚠️ Security Note: Ensure your tutor server is properly secured with HTTPS and network access controls before sharing access with team members.
Quick Reference
| Who | What They Need | Where to Get It |
|---|---|---|
| Admin | Database URL | Supabase/NeonDB/PostgreSQL |
| Admin | Server hosting | Your infrastructure |
| Team Members | Server URL | Admin provides (e.g., https://Devhelion.company.com) |
| Team Members | Tutor Server URL (for dashboard) | Admin provides (same as CLI server URL) |
| Team Members | Devhelion.ai account | Sign up at Devhelion.ai |
Troubleshooting
❌ "Connection refused" when team member enables
Problem: CLI can't reach the server
Solutions:
- Verify server is running:
Devhelion server status(on server machine) - Check firewall allows the port
- Verify the server URL is correct:
Devhelion config show
⚠️ Dashboard shows "Connection failed"
Problem: Dashboard can't connect to the tutor server
Solutions:
- Verify the Tutor Server URL is correct
- Check the server is running:
curl https://your-server/api/health - Ensure CORS allows connections from Devhelion.ai
- For HTTPS: ensure SSL certificate is valid
ℹ️ No data appearing in dashboard
Problem: Dashboard is connected but shows no events
Solutions:
- Ensure CLI is enabled:
Devhelion status - Check CLI is pointing to correct server:
Devhelion config show - Verify server is receiving data:
curl https://your-server/api/telemetry/stats - Use Claude Code or Cursor to generate some telemetry events
🎉 You're All Set!
Your team now has Devhelion running on your own infrastructure with complete privacy and control. All AI analytics data stays on your database - Devhelion never sees your data.