mirror/matrix-docker-ansible-deploy
1
0
Fork 0
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy.git synced 2025-02-04 22:35:02 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update files for matrix-appservice-irc: add the common section "Troubleshooting"

Browse Source 
Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
This commit is contained in:
Suguru Hirahara 2025-01-30 00:15:42 +09:00
parent 2d34074858
commit 684f1dc16e
No known key found for this signature in database
GPG Key ID: E4F9743DAB4B7B75
2 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
docs/configuring-playbook-bridge-appservice-irc.md
View File

@ -89,3 +89,22 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use
## Usage ## Usage
To use the bridge, you need to start a chat with `@irc_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). To use the bridge, you need to start a chat with `@irc_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain).
## Troubleshooting
As with all other services, you can find the logs in [systemd-journald](https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html) by logging in to the server with SSH and running `journalctl -fu matrix-appservice-irc`.
### Configuring for logging
The default logging level for this component is `debug`, and the log is output to the console only. If you want to change the verbosity or enable logging to a file, add the following configuration to your `vars.yml` file (adapt to your needs) and re-run the playbook:
```yaml
matrix_appservice_irc_configuration_extension_yaml: |
logging:
# Level to log on console/logfile. One of error|warn|info|debug
level: "debug"
# The file location to log to. This is relative to the project directory.
logfile: "debug.log"
# The file location to log errors to. This is relative to the project directory.
errfile: "errors.log"
```

3
roles/custom/matrix-bridge-appservice-irc/templates/config.yaml.j2
View File

@ -78,8 +78,7 @@ ircService:
level: "debug" level: "debug"
# The file location to log to. This is relative to the project directory. # The file location to log to. This is relative to the project directory.
#logfile: "debug.log" #logfile: "debug.log"
# The file location to log errors to. This is relative to the project # The file location to log errors to. This is relative to the project directory.
# directory.
#errfile: "errors.log" #errfile: "errors.log"
# Whether to log to the console or not. # Whether to log to the console or not.
toConsole: true toConsole: true