Documentation Index
Fetch the complete documentation index at: https://mocha-docs.embrly.ca/llms.txt
Use this file to discover all available pages before exploring further.
Requirements
- Docker 24+
- Docker Compose v2
Quick start
Create a docker-compose.yml file on your server:
services:
mocha_postgres:
container_name: mocha_postgres
image: postgres:16
restart: always
volumes:
- pgdata:/var/lib/postgresql/data
environment:
POSTGRES_USER: mocha
POSTGRES_PASSWORD: ${DB_PASSWORD}
POSTGRES_DB: mocha
mocha:
container_name: mocha
image: emberlyoss/mocha:latest
ports:
- "${PORT:-3000}:${PORT:-3000}"
- "${API_PORT:-5003}:${API_PORT:-5003}"
restart: always
depends_on:
- mocha_postgres
environment:
DB_USERNAME: "mocha"
DB_PASSWORD: ${DB_PASSWORD}
DB_HOST: "mocha_postgres"
DATABASE_URL: "postgresql://mocha:${DB_PASSWORD}@mocha_postgres/mocha"
SECRET: ${SECRET}
PORT: ${PORT:-3000}
API_PORT: ${API_PORT:-5003}
volumes:
pgdata:
.env file alongside it with your secrets:
DB_PASSWORD=a-strong-random-password
SECRET=a-very-long-random-string
# Optional: override default ports
# PORT=3000
# API_PORT=5003
Never commit real credentials to source control. Use a password manager or openssl rand -hex 32 to generate secrets.
Default credentials
Change the default password immediately from Settings → Profile after first login.
Environment variables
| Variable | Description | Default |
|---|
DB_PASSWORD | PostgreSQL password | — |
SECRET | JWT signing secret — use a long random string | — |
PORT | Client (Next.js) port | 3000 |
API_PORT | API (Fastify) port | 5003 |
DB_USERNAME | PostgreSQL username | mocha |
DB_HOST | PostgreSQL host | mocha_postgres |
Nightly builds
To run the latest nightly image instead of the stable release, change the image tag:
image: emberlyoss/mocha:nightly
Updating
docker compose pull
docker compose up -d
Exposing via a reverse proxy
If you want Mocha accessible on a domain rather than a raw IP, see the Reverse Proxy guide.
