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.