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.
-
Chat, pages, files
BrowserHTTPS, TCP 443Reverse proxyApp :8080 -
Voice, video, screen sharing
BrowserUDP 50000–50050App (SFU) -
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:
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.
- A VPSA public IPv4 address and no router to configure.
- Synology NASContainer Manager on DSM 7.2 or later.
- UnraidThe terminal, an appdata folder and Compose.
- Just try itOne computer, no domain, ten minutes.
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.