Skip to main content
The fastest way to self-host Inbox Zero is with two commands: 
npx @inbox-zero/cli setup      # One-time setup wizard
npx @inbox-zero/cli start      # Start containers
Then open http://localhost:3000 (or your domain).
Prerequisites: Docker and Node.js v22+ must be installed.
The CLI will walk you through configuring Google OAuth or Microsoft OAuth and your AI provider. For manual configuration, see the Setup Guides.
CLI is optional: The setup command is a convenience wrapper that helps prepare your .env and run Docker Compose with sensible defaults.Prefer manual setup? Clone the repo, copy apps/web/.env.example to apps/web/.env, and run the Docker/Node commands that match your environment.

​
Install Options

You can also install the CLI globally instead of using npx: 
npm install -g @inbox-zero/cli
inbox-zero setup
inbox-zero start

​
CLI Command Reference

CommandDescription
inbox-zero setupOne-time setup wizard
inbox-zero startStart containers
inbox-zero stopStop containers
inbox-zero updatePull latest image and restart
inbox-zero logs -fFollow container logs
inbox-zero statusShow container status
inbox-zero configInteractive configuration editor
inbox-zero config set <key> <value>Set a config value
inbox-zero config get <key>Get a config value

​
Updating

To update to the latest version: 
inbox-zero update
Or manually with Docker Compose: 
docker compose pull web
NEXT_PUBLIC_BASE_URL=https://yourdomain.com docker compose --profile all up -d

​
Uninstalling / Starting Over

Need to remove Inbox Zero or start fresh? See the full cleanup guide in Troubleshooting.

​
Next Steps

Google OAuth

Configure Google OAuth credentials and Gmail API access.

Microsoft OAuth

Configure Azure app registration and Graph permissions.

All Guides

PubSub, AI providers, and more manual configuration options.

Docker/VPS Deployment Guide

Production deployment, Docker profiles, and scheduled tasks.

Vercel Deployment

Deploy on Vercel with Neon Postgres and Upstash Redis.

AWS Deployment

Deploy on AWS using EC2, Terraform, or AWS Copilot.

Troubleshooting

Solutions for common issues like OAuth errors, rate limiting, and more.