whiterabbit

Date: 2025-10-02
Version: 1.1.0
Name: whiterabbit – auto-configure Matrix homeservers (Dendrite, Synapse, or Tuwunel)

About

All Matrix homeservers share the same Coturn instance. TLS certificates are issued automatically via Let’s Encrypt. Requires docker, docker-compose, nginx, certbot, and coturn.

Usage

Install or configure the global Coturn server.

 wh turn <domain> <ip> <device> <secret>

Add a new Matrix Dendrite server with automatic TLS and Nginx reverse proxy.

 wh dendrite <domain> <email> <server_ip>

Add a new Matrix Synapse server with automatic TLS and Nginx reverse proxy.

 wh synapse <domain> <email> <server_ip>

Add a Tuwunel homeserver with automatic TLS and Nginx reverse proxy.

 wh tuwunel <domain> <email> <server_ip>

List all configured Matrix servers and their container status.

 wh list

Remove one or more Matrix servers by domain name.

 wh remove <domain_name>