Skip to content

Self-hosting

Install

Run ZeroWidth on your own computer or on one server inside your network.

View as Markdown

You need Node 24 or later. Install ZeroWidth once, and the zerowidth command is ready everywhere. 0w is a short name for the same command.

On your computer

Terminal
npm i -g @zerowidth/cli
zerowidth init --db team.db
zerowidth doctor
zerowidth serve --db team.db

serve starts the console, and MCP at /mcp, at http://127.0.0.1:4380. Only this computer can reach ZeroWidth. Try ZeroWidth in five minutes

For your team

Serve wider, and everyone on your network reads the same record.

Terminal
zerowidth serve --db team.db --host 0.0.0.0

ZeroWidth makes a token on first start. Open the console once at /?token=<token>, and agents send the token with each request.

Treat the token as a shared team password, and serve only inside your network.

Check your setup

doctor checks everything an install needs, one line each, with what to do about anything wrong. Add --online to also check your OpenRouter key, which costs nothing.

Terminal
zerowidth doctor --online