9accc848c4
- Traefik's service list entry now uses the `traefik_restart_necessary` variable (computed by the Traefik role) instead of hardcoded `true`, so it is only restarted when its config, systemd unit, or image changed. - `just setup-all` now passes `devture_systemd_service_manager_conditional_restart_enabled=false` to force unconditional restarts, matching its "full setup" semantics. - Document the conditional restart behavior in docs/just.md. Some benchmarks follow for `just install-service traefik -l matrix.example.com` when Traefik settings did not change and a restart is not really necessary: - Before: - total time: 56 seconds 🐌 - Traefik restarted: yes ❌ - Services that depend on Traefik restarted: yes; all of them restarted ❌ - After: - total time: 27 seconds ⚡ - Traefik restarted: no ✅ - Services that depend on Traefik restarted: no; none restarted ✅ Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Table of Contents
⬇️ Installation guides
There are two installation guides available for beginners and advanced users.
-
⚡ Quick start (for beginners): this is recommended for those who do not have an existing Matrix server and want to start quickly with "opinionated defaults".
-
Full installation guide (for advanced users): if you need to import an existing Matrix server's data into the new server or want to learn more while setting up the server, follow this guide.
🛠️ Configuration options
You can check useful documentation for configuring components here: Configuring the playbook
-
Administration — services that help you in administrating and monitoring your Matrix installation
-
Authentication and user-related — extend and modify how users are authenticated on your homeserver
-
Bots — bots provide various additional functionality to your installation
-
Bridges — bridges can be used to connect your Matrix installation with third-party communication networks
-
Clients — web clients for Matrix that you can host on your own domains
-
Core service adjustments — backbone of your Matrix system
-
File Storage — use alternative file storage to the default
media_storefolder
- Other specialized services — various services that don't fit any other categories
👨🔧 Maintenance
If your server and services experience issues, feel free to come to our support room and ask for help.
Other documentation pages
- ℹ️ FAQ — various Frequently Asked Questions about Matrix, with a focus on this Ansible playbook