Skip to content

Backend Configuration

The backend server is configured via .app-config.{json,yaml} files or environment variables.

The port the server listens on

Type: integer (Required)

Default: 50051


Path to static files to serve (optional)

Type: string | null (Optional)


Base path for the API

Type: string (Required)

Default: "/mzchat"


Database connection URL (e.g. file:backend.db)

Type: string | null (Optional)


Database backend type

Type: string (Required)

Default: "sqlite"

Allowed Values: sqlite, postgres, libsql


The canonical public address of the server

Type: string (Required)

Default: "http://localhost:50051"


Domain used for serving assets (defaults to canonicalAddress)

Type: string | null (Optional)


Path to database migrations

Type: string (Required)

Default: "drizzle"


Path to store uploaded files

Type: string (Required)

Default: "uploads"


Directory for storing state (database, secrets, etc.)

Type: string | null (Optional)


Meilisearch URL (optional)

Type: string | null (Optional)


Meilisearch API Key (optional)

Type: string | null (Optional)


Meilisearch index name

Type: string (Required)

Default: "mzchat-messages"


Path to embedded Meilisearch database

Type: string | null (Optional)


Secret used for signing JWTs

Type: string | null (Optional)


Logging level (info, debug, error, etc.)

Type: string (Required)

Default: "info"


Whether to run database migrations on startup

Type: boolean (Required)

Default: true


Trust X-Forwarded-For from a reverse proxy so rate limits see client addresses (enable only behind a proxy)

Type: boolean (Optional)

Default: false


Allow outbound federation and push requests to loopback and private addresses (for local testing only)

Type: boolean (Optional)

Default: false


IRC Server Configuration

Type: Object

Enable the IRC server

Type: boolean (Optional)

Default: false


Port for the IRC server

Type: integer (Optional)

Default: 6667


Public facing host for the IRC server (optional)

Type: string | null (Optional)


Public facing port for the IRC server (optional)

Type: integer | null (Optional)



S3 Storage Configuration

Type: Object

Type: string | null (Optional)

Default: "http://localhost:9000"


Type: string | null (Optional)

Default: "us-east-1"


Type: string | null (Optional)

Default: "mzchat-uploads"


Required when endpoint is set

Type: string | null (Optional)


Required when endpoint is set

Type: string | null (Optional)


Type: string | null (Optional)


Type: boolean (Optional)

Default: false



LiveKit Configuration

Type: Object

LiveKit server URL

Type: string (Optional)

Default: "http://localhost:7880"


LiveKit API Key. Calls are disabled unless both key and secret are set.

Type: string | null (Optional)


LiveKit API Secret

Type: string | null (Optional)