self-hosted/matrix-docker-ansible-deploy

mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy.git synced 2024-12-12 08:43:55 +02:00

Suguru Hirahara 6e4ad586e4

Replace existing links to matrix-org/synapse which should be replaced

Note that links to the issues and PRs on the original repository (matrix-org/synapse) should not be replaced with ones on the forked one (element-hq/synapse) as those are not available on the latter, where the issues and PRs with the same number as matrix-org/synapse are "reserved" to avoid conflicts between those repositories. For reasoning of such complexity (including the reason why trasferring the original repository to element-hq/synapse was avoided), see: https://github.com/element-hq/synapse/issues/6#issuecomment-1861116896

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>

2024-10-28 16:43:35 +09:00

2.2 KiB

Raw Blame History

Maintenance and Troubleshooting

How to see the current status of your services

You can check the status of your services by using systemctl status. Example:

sudo systemctl status matrix-synapse

● matrix-synapse.service - Synapse server
     Loaded: loaded (/etc/systemd/system/matrix-synapse.service; enabled; vendor preset: enabled)
     Active: active (running) since Sun 2024-01-14 09:13:06 UTC; 1h 31min ago

Docker containers that the playbook configures are supervised by systemd and their logs are configured to go to systemd-journald.

To prevent double-logging, Docker logging is disabled by explicitly passing --log-driver=none to all containers. Due to this, you cannot view logs using docker logs.

To view systemd-journald logs using journalctl, run a command like this:

sudo journalctl -fu matrix-synapse

Increasing Synapse logging

Because the Synapse Matrix server is originally very chatty when it comes to logging, we intentionally reduce its logging level from INFO to WARNING.

If you'd like to debug an issue or report a Synapse bug to the developers, it'd be better if you temporarily increasing the logging level to INFO.

Example configuration (inventory/host_vars/matrix.example.com/vars.yml):

matrix_synapse_log_level: "INFO"
matrix_synapse_storage_sql_log_level: "INFO"
matrix_synapse_root_log_level: "INFO"

Re-run the playbook after making these configuration changes.

Remove unused Docker data

You can free some disk space from Docker, see docker system prune for more information.

ansible-playbook -i inventory/hosts setup.yml --tags=run-docker-prune

Postgres

See the dedicated PostgreSQL Maintenance documentation page.

Ma1sd

See the dedicated Adjusting ma1sd Identity Server configuration documentation page.

2.2 KiB Raw Blame History