Tuwunel
Tuwunel is a high-performance Matrix homeserver written in Rust, providing self-hosters a scalable, low-cost alternative to Synapse and a maintained successor…
Platform availability
Available on 2 of 10 platforms
- Unraid (not listed)
- TrueNAS
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
80/100 Excellent
- Maintained
- 100last commit 11 days ago
- Popular
- 692,755 GitHub stars
- Easy to install
- 352 install platforms, install notes
- Light to run
- No data
- Security check
- 100no serious findings, CI, tests
Based on 4 of 5 factors.
Availability: platform listings confirmed today
- GitHub stars
- 2,755
- Open issues
- 71
- Last commit
- 2026-11-10
- Latest release
- v1.9.4
- License
- Apache-2.0
- Activity
- steady
Checked 11 days ago - source: GitHub (matrix-construct/tuwunel)
Resources & Compatibility
Requirements not published yet.
First-install notes
- Fill in the server name and folder paths Set server_name, address, port, and database_path in the Tuwunel configuration before starting it, where database_path is the folder where Tuwunel stores its data. If server_name or database_path is wrong, Tuwunel may fail to start or fail to save your data safely. source
- Give Tuwunel a service user and owned folders Create a dedicated service account for the app and make it own the config, database, and log folders before starting it. If permissions are wrong, Tuwunel can fail with permission denied, such as NetBSD failing to write /var/log/tuwunel.log. source
- Enable the service to start on boot After the configuration and folders are ready, enable and start the Tuwunel service so it runs now and after a reboot. Without enabling it, you may need to start it manually every time the machine restarts. source
Fetched 11 days ago - each note links to its source
Variants
Alternatives (11)
- Discord
- Element
- Jitsi Meet - Jitsi Meet is an open-source, self-hosted video conferencing platform offering HD audio and video, screen sharing, in-meeting chat, and unl…
- Matrix - Matrix is a free, open-source protocol and server for secure, decentralized real-time messaging.
- Mumble - Mumble is an open-source, low-latency voice-over-IP server that lets multiple Mumble clients from gaming groups and teams talk to each othe…
- Signal - Signal is a messaging app with privacy at its core.
- Slack - Slack is a secure team messaging and collaboration platform, provided here as a Kasm container that gives you a private, dedicated workspac…
- Stoat Chat - Instant messaging with text, voice, video calling, screen sharing, privacy controls, customizable permissions, moderation, bots, and open-s…
- Telegram - Telegram is a cloud-based mobile and desktop messaging app.
- WhatsApp - Free messaging without SMS fees, web sync, and multimedia sharing, supporting group and video chats, available on iPhone, Android, and desk…
- Wire - User-friendly messaging platform with end-to-end encrypted chats, voice and video calls, self-deleting messages, file sharing features, and…
Checked 11 days ago - source: AlternativeTo
Common questions
Will Docker work if the container listens on 127.0.0.1:8008 behind a reverse proxy on the host?
No, if Tuwunel is in Docker and uses a loopback/localhost listening address such as 127.0.0.1:8008 while a reverse proxy communicates to it through NAT-based networking, that setup will not work.
Can I host Matrix under matrix.example.com while user IDs stay as @user:example.com?
The default server name is the domain in Matrix user IDs, and it must exactly match the host Tuwunel presents when federating. The deployment docs call out hosting under a subdomain while user IDs use the root domain as a separate configuration case.
Why are debug or trace logs missing from a normal Tuwunel build?
Default builds omit debug and trace log levels to improve CPU usage and compile times. To access those log levels, build without the release_max_log_level feature.
Can Tuwunel be used instead of Synapse with existing clients, bridges, and bots?
Yes, it is described as a Matrix homeserver you can use instead of Synapse with your favorite client, bridge, or bot. It is also described as fully implementing the Matrix Specification for all but the most niche uses.
Answers sourced from gist.github.com, github.com, github.com, matrix-construct.github.io
Community
- Tuwunel admin interface · matrix-construct tuwunel · Discussion #153 (forum)
- 发个病,搭建一下 tuwunel - 开发调优 - LINUX DO (forum)
- tuwunel 的搭建 (Cloudflare) - 开发调优 - LINUX DO (forum)
Collected 11 days ago - public community threads