Update docs/maintenance-and-troubleshooting.md: tidy up

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
This commit is contained in:
Suguru Hirahara 2025-01-30 13:29:38 +09:00
parent 2473581b3a
commit 038d046612
No known key found for this signature in database
GPG Key ID: E4F9743DAB4B7B75

View File

@ -14,14 +14,14 @@ sudo systemctl status matrix-synapse
Docker containers that the playbook configures are supervised by [systemd](https://wiki.archlinux.org/title/Systemd) and their logs are configured to go to [systemd-journald](https://wiki.archlinux.org/title/Systemd/Journal). Docker containers that the playbook configures are supervised by [systemd](https://wiki.archlinux.org/title/Systemd) and their logs are configured to go to [systemd-journald](https://wiki.archlinux.org/title/Systemd/Journal).
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](https://man.archlinux.org/man/journalctl.1), log in to the server with SSH and run a command like this:
To view systemd-journald logs using [journalctl](https://man.archlinux.org/man/journalctl.1), run a command like this:
```sh ```sh
sudo journalctl -fu matrix-synapse sudo journalctl -fu matrix-synapse
``` ```
**Note**: 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`.
## How to check if services work ## How to check if services work
The playbook can perform a check to ensure that you've configured things correctly and that services are running. The playbook can perform a check to ensure that you've configured things correctly and that services are running.
@ -40,7 +40,7 @@ Besides this self-check, you can also check whether your server federates with t
## Remove unused Docker data ## Remove unused Docker data
You can free some disk space from Docker, see [docker system prune](https://docs.docker.com/engine/reference/commandline/system_prune/) for more information. You can free some disk space from Docker by removing its unused data. See [docker system prune](https://docs.docker.com/engine/reference/commandline/system_prune/) for more information.
```sh ```sh
ansible-playbook -i inventory/hosts setup.yml --tags=run-docker-prune ansible-playbook -i inventory/hosts setup.yml --tags=run-docker-prune