https://github.com/jaywink/ansible-maubot
https://github.com/jaywink/ansible-maubot
ansible matrix maubot
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/jaywink/ansible-maubot
- Owner: jaywink
- License: apache-2.0
- Created: 2021-02-26T00:21:02.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-24T21:20:23.000Z (over 1 year ago)
- Last Synced: 2024-10-29T02:21:21.363Z (about 1 year ago)
- Topics: ansible, matrix, maubot
- Homepage:
- Size: 14.6 KB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Ansible Maubot
Matrix Maubot using Docker.
Runs and configures a single Maubot instance, optionally using an existing
account. If not using an existing account, you need to set up one using the
Maubot CLI commands.
Traefik friendly via Docker container labels.
## Installing
`ansible-galaxy install jaywink.ansible_maubot`
## Configuration
### Required
```yaml
maubot_admin_password: settosomethingsupersecret
maubot_homeserver_name: domain.tld
maubot_homeserver_url: https://matrix.domain.tld
maubot_domain: maubot.domain.tld
maubot_synapse_registration_shared_secret: secretthing
maubot_unshared_secret: changemetosomethingsecret
```
### Client
Set these if using an existing account.
```yaml
# This only inserts the client the first time - it does not
# overwrite any values changed via the management interface!
# NOTE! Only supports debian based systems currently.
maubot_client_mxid: @maubot:domain.tld
maubot_client_access_token: secretthing
# Required if encrypted message support is needed
maubot_client_device_id: ABCDEFGH
# Optional
maubot_client_displayname: Maubot
maubot_client_avatar_url: mxc://domain.tld/etc
```
### Optional
These defaults will be used if not set.
```yaml
maubot_admin_username: admin
maubot_docker_image: dock.mau.dev/maubot/maubot:v0.5.0
# Use for example to hook up with Traefik
maubot_docker_labels: []
# Docker network to attach to
maubot_docker_network: default
# Paths for the management page and plugins
maubot_server_ui_base_path: "/maubot"
maubot_server_plugin_base_path: "/maubot/plugin/"
```
## License
Apache 2.0