https://github.com/medienhaus/medienhaus-ansible

The medienhaus/ Ansible playbook
https://github.com/medienhaus/medienhaus-ansible

ansible matrix-org

Last synced: 28 days ago
JSON representation

The medienhaus/ Ansible playbook

• Host: GitHub
• URL: https://github.com/medienhaus/medienhaus-ansible
• Owner: medienhaus
• License: agpl-3.0
• Created: 2021-04-03T16:01:09.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-11-19T14:32:34.000Z (about 1 month ago)
• Last Synced: 2024-11-19T15:38:47.020Z (about 1 month ago)
• Topics: ansible, matrix-org
• Language: CSS
• Homepage: https://medienhaus.dev/
• Size: 2.7 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


### medienhaus/

Customizable, modular, free and open-source environment for decentralized, distributed communication and collaboration without third-party dependencies.

[Website](https://medienhaus.dev/) — [Fediverse](https://chaos.social/@medienhaus)




# medienhaus-ansible

This repository contains our Ansible roles and playbook for an automated installation of matrix-synapse and dependencies, our customized element-web, our [medienhaus-backend](https://github.com/medienhaus/medienhaus-backend), and our [medienhaus-frontend](https://github.com/medienhaus/medienhaus-frontend).

**Note:** Tested and working in Ubuntu 20.04 LTS unprivileged Linux containers (LXC).

**TODO:** finalize and then add [medienhaus-cms](https://github.com/medienhaus/medienhaus-cms) …

## Development

### Installation

* see: [Install Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html) from the official Ansible docs

### Configuration

* Ansible is configured via [ansible.cfg](ansible.cfg.example)

* Hosts are defined in [inventories/example/inventory.yml](inventories/example/inventory.yml.example)

* Host variables are defined in [inventories/example/host_vars/](inventories/example/host_vars/)

* Roles are defined in [roles/](roles/)

* Playbooks are defined in [playbooks/](playbooks/)

**Note:** Make sure the `private_key` and `vault_password` files are referenced correctly and put in place.

### Running the Ansible playbook

```bash

# after configuring Ansible via ansible.cfg, your host(s) via inventory.yml,

# the host variables via host_vars/your_host/*, and playbooks/medienhaus.yml

ansible-playbook playbooks/medienhaus.yml

```

**Note:** Make sure the `hosts` are referenced correctly in [playbooks/medienhaus.yml](playbooks/medienhaus.yml#L3) and the inventory file.

### Registering a user

* see: [Registering a user](https://matrix-org.github.io/synapse/latest/setup/installation.html#registering-a-user) from the official Matrix-Synapse docs

* if registration is [enabled](inventories/example/host_vars/example/main.yml#L33): `https://{{ synapse_server_name }}/classroom/#/register`