Skip to main content

Requirements

  • Docker 24+
  • Docker Compose v2

Quick start

Create a docker-compose.yml file on your server:
Create a .env file alongside it with your secrets:
Never commit real credentials to source control. Use a password manager or openssl rand -hex 32 to generate secrets.
Start the stack:
Mocha is now running at http://your-server-ip:3000

Default credentials

Change the default password immediately from Settings → Profile after first login.

Environment variables

Nightly builds

To run the latest nightly image instead of the stable release, change the image tag:

Updating

Exposing via a reverse proxy

If you want Mocha accessible on a domain rather than a raw IP, see the Reverse Proxy guide.