Skip to main content
The fastest way to self-host Inbox Zero is with two commands:
Then open http://localhost:3000 (or your domain).
Prerequisites: Docker and Node.js v24+ 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:

​
CLI Command Reference

​
Updating

To update to the latest version:
Or manually with Docker Compose:

​
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.

Image Proxy

Deploy the optional remote-image proxy without editing Worker config files.

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.