mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2024-12-26 12:05:09 +01:00

History

Kevin Veen-Birkenbach 59b7cdab5d Removed wrong path		2023-12-14 16:06:02 +01:00
..
handlers	Matrix draft	2023-12-12 22:36:35 +01:00
meta	Matrix draft	2023-12-12 22:36:35 +01:00
tasks	Removed wrong path	2023-12-14 16:06:02 +01:00
templates	Migrated some application to MariaDB and changed versions of Postgres to stay compatible with current installations	2023-12-14 01:34:12 +01:00
vars	Matrix draft	2023-12-12 22:36:35 +01:00
README.md	Implemented matrix role README.md and optimized general README.md	2023-12-13 10:27:21 +01:00

README.md

Docker-Matrix Role README

Overview

This document serves as the README for the docker-matrix role, a part of the CyMaIS project. This role automates the deployment of a Matrix server using Docker.

Matrix is an open-source project that provides a protocol for secure, decentralized, real-time communication. It offers features like end-to-end encrypted chat, VoIP, and file sharing, catering to both individual and enterprise users. With a focus on interoperability, Matrix can bridge with other communication systems, offering a unified platform for messaging and collaboration.

Dependencies

nginx-docker-reverse-proxy (see meta/main.yml)

Files and Their Functions

vars/main.yml: Defines variables such as docker_compose_instance_directory.
handlers/main.yml: Contains handlers like recreate matrix for restarting the Matrix service.
tasks/main.yml: Contains main tasks like creating directories and configuration files.
templates/log.config.j2: Template for the Matrix server's logging configuration.
templates/homeserver.yaml.j2: Template for the main configuration file of the Matrix server.
templates/docker-compose.yml.j2: Docker-Compose template for setting up the Matrix server and database.

Important Administration Commands

Create Matrix Users:

docker exec -it [Container-ID] register_new_matrix_user -u [Username] -p [Password] -a -c /data/homeserver.yaml http://localhost:8008

Execute Docker-Compose Commands:

Restart services:
```
docker-compose up -d --force-recreate
```
View logs:
```
docker-compose logs
```