Matrix Connection Tester UI

A web-based tool to check if a Matrix server is reachable and federates correctly with the wider Matrix network.
Inspired by federationtester.matrix.org, this UI provides clear feedback on federation status, server software, and detailed debug information.

It requires https://github.com/MTRNord/rust-federation-tester as a backend API, which can be run locally or pointed to an existing compatible service.

---

Features

• Federation Check: See if a Matrix server federates successfully.
• Server Software Detection: Identifies common Matrix server implementations and their maturity.
• Debug Information: View DNS, well-known, and connection reports.
• Accessible UI: Built with govuk-react for clarity and accessibility.
• Raw API Output: Inspect the full API response for troubleshooting.

---

Quick Start

1. Run with Docker

docker run --rm -p 8080:80 ghcr.io/MTRNord/matrix-connection-tester-ui:latest

2. Build & Run Locally

git clone https://github.com/MTRNord/matrix-connection-tester-ui.git
cd matrix-connection-tester-ui
pnpm install
pnpm run dev

Then open http://localhost:5173 in your browser.

---

Usage

1. Enter the Matrix server name (e.g. matrix.org) in the input field.
2. Click Go.
3. View federation status, server software, and detailed debug info.

---

API

This UI expects https://github.com/MTRNord/rust-federation-tester to be running as a backend API.

---

Docker

A prebuilt Docker image is available via GitHub Container Registry (ghcr.io):

docker pull ghcr.io/MTRNord/matrix-connection-tester-ui:latest

---

Roadmap

• Add Internationalization (i18n) support
• Improve error handling and user feedback
• Add guides explaining common issues and how to resolve them
• Implement a way to attach the server name as a query parameter to the URL

---

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
See LICENSE for details.

---

Contributing

Contributions are welcome! Please open issues or pull requests on GitHub.

---

Credits

• GOV.UK React
• Matrix Federation Tester