matrix-ntfy: documentation

This commit is contained in:
Julian Foad
2022-06-27 22:20:02 +01:00
parent 2a516a16fb
commit 85b12b74a7
7 changed files with 71 additions and 36 deletions

View File

@ -1,40 +1,5 @@
# A role to install the [ntfy](https://ntfy.sh) push-notification server.
The ntfy server and clients implement self-hosted support push notifications
from Matrix (and other) servers to Android (and other) clients, using the
[UnifiedPush](https://unifiedpush.org) standard.
This role installs ntfy server in Docker. It is intended to support push
notifications, via UnifiedPush, from the Matrix and Matrix-related services
that are installed alongside it to any clients that support UnifiedPush.
This role is not intended to support other features of the ntfy server and
clients.
# Using the ntfy role
Configure the role by adding settings in your Ansible inventory.
The only required setting is to enable ntfy:
matrix_ntfy_enabled: true
The default domain for ntfy is `ntfy.<matrix_domain>`. This can be changed
with the `matrix_server_fqn_ntfy` variable:
matrix_server_fqn_ntfy: "my-ntfy.{{ matrix_domain }}"
Other ntfy settings can be configured by adding extra arguments to the
docker run command, e.g.:
matrix_ntfy_container_extra_arguments:
- '--env=NTFY_LOG_LEVEL=DEBUG'
# TODO
- Documentation.
- Self-check.
- Mount the ntfy database to disk so subscriptions persist across restarts.
- Authentication?

View File

@ -12,5 +12,5 @@ matrix_ntfy_docker_image_force_pull: "{{ matrix_ntfy_docker_image.endswith(':lat
# Takes an "<ip>:<port>" or "<port>" value (e.g. "127.0.0.1:8768"), or empty string to not expose.
matrix_ntfy_container_http_host_bind_port: ''
# A list of extra arguments to pass to the container
# A list of extra arguments to pass to the container (`docker run` command)
matrix_ntfy_container_extra_arguments: []