Host Mnema Talk

Every community needs one person who hosts it. If that is you, this guide gets you from an empty folder to the first call, then covers updates, backups and repairs.

What you are setting up

Three containers on a machine you control: the Mnema Talk server, PostgreSQL for data and SeaweedFS for files. A reverse proxy in front gives the server its HTTPS address.

How a member’s browser reaches your server
  1. Chat, pages, files

    BrowserHTTPS, TCP 443Reverse proxyApp :8080
  2. Voice, video, screen sharing

    BrowserUDP 50000–50050App (SFU)
  3. Fallback for strict networks

    BrowserUDP and TCP 3479Built-in TURN relayApp :8080

On your machine, Docker Compose runs three containers: the app (web, API and voice), PostgreSQL for data and SeaweedFS for files.

Voice and video bypass the proxy: browsers send them as UDP packets straight to the server. That is why a home line behind CGNAT cannot host calls.

What you need

  • A machine with Docker and Compose: a NAS, a Raspberry Pi 4 or 5, any Linux machine or a small VPS. See Choosing a machine.
  • A domain name such as chat.example.com, because microphones only work on HTTPS pages. See Domain, DNS and TLS.
  • Three open ports: TCP 443 for the site, UDP 50000–50050 for voice and video, and 3479 (UDP and TCP) for the built-in relay. See Ports and firewall.
  • About an hour the first time.

The short version

On a machine with Docker, in an empty folder:

Make the files, then start
mkdir mnema-talk && cd mnema-talkdocker run --rm -it --user "$(id -u):$(id -g)" \
  -v "$PWD:/out" ghcr.io/mnema-xyz/mnema-talk setupdocker compose up -d --wait

The setup assistant asks a few questions and writes .env and docker-compose.yml with every secret. Then you put HTTPS in front, open the ports and sign in as the Owner. Installation covers each step.

Why there is no hosted version

Text messages are not end-to-end encrypted; the server can read them. That is fine when the server belongs to your group, and it would not be if it belonged to us. Your copy also keeps running whatever happens to the project; the code is AGPL-3.0.

You pay no platform for hosting: run it on hardware you have, or on a small VPS at a host you pick for a few euros a month. Moving later is a backup and a restore.

Something wrong on this page? Tell us.