ntfy/server/server.yml

98 lines
3.3 KiB
YAML
Raw Normal View History

2021-12-19 04:02:36 +01:00
# ntfy server config file
2021-12-25 00:57:02 +01:00
# Public facing base URL of the service (e.g. https://ntfy.sh or https://ntfy.example.com)
# This setting is currently only used by the e-mail feature.
#
# base-url:
2021-12-18 20:43:27 +01:00
# Listen address for the HTTP & HTTPS web server. If "listen-https" is set, you must also
2021-12-25 00:57:02 +01:00
# set "key-file" and "cert-file". Format: <hostname>:<port>
#
# listen-http: ":80"
2021-12-02 14:52:48 +01:00
# listen-https:
2021-12-18 20:43:27 +01:00
# Path to the private key & cert file for the HTTPS web server. Not used if "listen-https" is not set.
2021-12-02 14:52:48 +01:00
#
# key-file:
# cert-file:
2021-10-29 20:03:41 +02:00
# If set, also publish messages to a Firebase Cloud Messaging (FCM) topic for your app.
2021-12-02 05:08:12 +01:00
# This is optional and only required to save battery when using the Android app.
2021-10-29 20:03:41 +02:00
#
# firebase-key-file: <filename>
2021-11-03 16:33:34 +01:00
# If set, messages are cached in a local SQLite database instead of only in-memory. This
# allows for service restarts without losing messages in support of the since= parameter.
#
2021-12-09 16:23:17 +01:00
# To disable the cache entirely (on-disk/in-memory), set "cache-duration" to 0.
#
# Note: If you are running ntfy with systemd, make sure this cache file is owned by the
# ntfy user and group by running: chown ntfy.ntfy <filename>.
#
2021-11-03 16:33:34 +01:00
# cache-file: <filename>
2021-10-29 20:03:41 +02:00
# Duration for which messages will be buffered before they are deleted.
# This is required to support the "since=..." and "poll=1" parameter.
#
2021-12-09 16:23:17 +01:00
# You can disable the cache entirely by setting this to 0.
#
2021-11-03 16:33:34 +01:00
# cache-duration: 12h
2021-10-29 20:03:41 +02:00
2021-12-25 00:57:02 +01:00
# If set, the X-Forwarded-For header is used to determine the visitor IP address
# instead of the remote address of the connection.
#
# WARNING: If you are behind a proxy, you must set this, otherwise all visitors are rate limited
# as if they are one.
#
# behind-proxy: false
# If enabled, allow e-mail notifications via the 'X-Email' header. As of today, only SMTP servers
# with plain text auth and STARTLS are supported. Please also refer to the rate limiting settings
# below (visitor-email-limit-burst & visitor-email-limit-burst).
#
# - smtp-addr is the hostname:port of the SMTP server
# - smtp-user/smtp-pass are the username and password of the SMTP user
# - smtp-from is the e-mail address of the sender
#
# smtp-addr:
# smtp-user:
# smtp-pass:
# smtp-from:
2021-12-27 16:39:28 +01:00
# smtp-server-listen:
# smtp-server-addr:
2021-10-29 20:03:41 +02:00
# Interval in which keepalive messages are sent to the client. This is to prevent
# intermediaries closing the connection for inactivity.
#
2021-12-02 05:08:12 +01:00
# Note that the Android app has a hardcoded timeout at 77s, so it should be less than that.
#
2021-10-29 20:03:41 +02:00
# keepalive-interval: 30s
# Interval in which the manager prunes old messages, deletes topics
# and prints the stats.
2021-10-29 20:03:41 +02:00
#
# manager-interval: 1m
# Rate limiting: Total number of topics before the server rejects new topics.
#
# global-topic-limit: 5000
# Rate limiting: Number of subscriptions per visitor (IP address)
#
# visitor-subscription-limit: 30
# Rate limiting: Allowed GET/PUT/POST requests per second, per visitor:
# - visitor-request-limit-burst is the initial bucket of requests each visitor has
# - visitor-request-limit-replenish is the rate at which the bucket is refilled
#
# visitor-request-limit-burst: 60
# visitor-request-limit-replenish: 10s
2021-12-24 00:03:04 +01:00
# Rate limiting: Allowed emails per visitor:
# - visitor-email-limit-burst is the initial bucket of emails each visitor has
# - visitor-email-limit-replenish is the rate at which the bucket is refilled
#
# visitor-email-limit-burst: 16
# visitor-email-limit-replenish: 1h