The previous image versions set ANSIBLE_WORKER_SESSION_ISOLATION=False in an attempt to restore SSH prompts on Ansible 2.21. That setting does not bring the prompts back — it makes Ansible hang silently at the first SSH connection whenever a prompt would have been needed. See https://github.com/devture/docker-ansible/issues/6 The new image auto-accepts the SSH host keys of previously unknown hosts instead. The docs stop recommending ANSIBLE_WORKER_SESSION_ISOLATION=False for direct (non-Docker) runs for the same reason, and now explain how to use an ssh-agent for passphrase-protected SSH keys. Co-Authored-By: Claude Fable 5 <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