2021-12-19 04:02:36 +01:00
|
|
|
# ntfy server config file
|
2022-05-16 17:32:21 +02:00
|
|
|
#
|
|
|
|
# Please refer to the documentation at https://ntfy.sh/docs/config/ for details.
|
|
|
|
# All options also support underscores (_) instead of dashes (-) to comply with the YAML spec.
|
2021-10-24 03:29:45 +02:00
|
|
|
|
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)
|
2022-06-16 18:42:19 +02:00
|
|
|
#
|
|
|
|
# This setting is required for any of the following features:
|
|
|
|
# - attachments (to return a download URL)
|
|
|
|
# - e-mail sending (for the topic URL in the email footer)
|
|
|
|
# - iOS push notifications for self-hosted servers (to calculate the Firebase poll_request topic)
|
|
|
|
# - Matrix Push Gateway (to validate that the pushkey is correct)
|
2021-12-25 00:57:02 +01:00
|
|
|
#
|
|
|
|
# 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
|
2022-01-16 04:33:35 +01:00
|
|
|
# set "key-file" and "cert-file". Format: [<ip>]:<port>, e.g. "1.2.3.4:8080".
|
2021-10-24 03:29:45 +02:00
|
|
|
#
|
2022-01-16 04:33:35 +01:00
|
|
|
# To listen on all interfaces, you may omit the IP address, e.g. ":443".
|
2022-01-15 02:16:12 +01:00
|
|
|
# To disable HTTP, set "listen-http" to "-".
|
|
|
|
#
|
2021-10-24 03:29:45 +02:00
|
|
|
# listen-http: ":80"
|
2021-12-02 14:52:48 +01:00
|
|
|
# listen-https:
|
|
|
|
|
2022-01-15 02:16:12 +01:00
|
|
|
# Listen on a Unix socket, e.g. /var/lib/ntfy/ntfy.sock
|
|
|
|
# This can be useful to avoid port issues on local systems, and to simplify permissions.
|
|
|
|
#
|
|
|
|
# listen-unix: <socket-path>
|
2022-07-04 01:36:58 +02:00
|
|
|
# listen-unix-mode: <linux permissions, e.g. 0700>
|
2022-01-15 02:16:12 +01:00
|
|
|
|
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
|
|
|
#
|
2022-02-01 22:40:33 +01:00
|
|
|
# key-file: <filename>
|
|
|
|
# cert-file: <filename>
|
2021-12-02 14:52:48 +01:00
|
|
|
|
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>
|
|
|
|
|
2022-06-23 17:02:45 +02:00
|
|
|
# If "cache-file" is 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-11-03 16:33:34 +01:00
|
|
|
#
|
2022-02-01 22:40:33 +01:00
|
|
|
# The "cache-duration" parameter defines the 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
|
|
|
# To disable the cache entirely (on-disk/in-memory), set "cache-duration" to 0.
|
2022-01-21 02:40:12 +01:00
|
|
|
# The cache file is created automatically, provided that the correct permissions are set.
|
2021-12-09 16:23:17 +01:00
|
|
|
#
|
2022-06-23 17:02:45 +02:00
|
|
|
# The "cache-startup-queries" parameter allows you to run commands when the database is initialized,
|
|
|
|
# e.g. to enable WAL mode (see https://phiresky.github.io/blog/2020/sqlite-performance-tuning/)).
|
|
|
|
# Example:
|
|
|
|
# cache-startup-queries: |
|
|
|
|
# pragma journal_mode = WAL;
|
|
|
|
# pragma synchronous = normal;
|
|
|
|
# pragma temp_store = memory;
|
2022-11-16 16:33:12 +01:00
|
|
|
# pragma busy_timeout = 15000;
|
|
|
|
# vacuum;
|
|
|
|
#
|
|
|
|
# The "cache-batch-size" and "cache-batch-timeout" parameter allow enabling async batch writing
|
|
|
|
# of messages. If set, messages will be queued and written to the database in batches of the given
|
|
|
|
# size, or after the given timeout. This is only required for high volume servers.
|
2022-06-23 17:02:45 +02:00
|
|
|
#
|
2022-01-21 02:40:12 +01:00
|
|
|
# Debian/RPM package users:
|
|
|
|
# Use /var/cache/ntfy/cache.db as cache file to avoid permission issues. The package
|
|
|
|
# creates this folder for you.
|
|
|
|
#
|
|
|
|
# Check your permissions:
|
|
|
|
# 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-12-09 04:08:44 +01:00
|
|
|
#
|
2021-11-03 16:33:34 +01:00
|
|
|
# cache-file: <filename>
|
2022-02-01 22:40:33 +01:00
|
|
|
# cache-duration: "12h"
|
2022-06-23 17:02:45 +02:00
|
|
|
# cache-startup-queries:
|
2022-11-16 16:28:20 +01:00
|
|
|
# cache-batch-size: 0
|
|
|
|
# cache-batch-timeout: "0ms"
|
2021-11-03 16:33:34 +01:00
|
|
|
|
2022-02-01 22:40:33 +01:00
|
|
|
# If set, access to the ntfy server and API can be controlled on a granular level using
|
|
|
|
# the 'ntfy user' and 'ntfy access' commands. See the --help pages for details, or check the docs.
|
2021-10-29 20:03:41 +02:00
|
|
|
#
|
2022-02-01 22:40:33 +01:00
|
|
|
# - auth-file is the SQLite user/access database; it is created automatically if it doesn't already exist
|
|
|
|
# - auth-default-access defines the default/fallback access if no access control entry is found; it can be
|
|
|
|
# set to "read-write" (default), "read-only", "write-only" or "deny-all".
|
2023-01-29 21:11:26 +01:00
|
|
|
# - auth-startup-queries allows you to run commands when the database is initialized, e.g. to enable
|
|
|
|
# WAL mode. This is similar to cache-startup-queries. See above for details.
|
2021-12-09 16:23:17 +01:00
|
|
|
#
|
2022-02-01 22:40:33 +01:00
|
|
|
# Debian/RPM package users:
|
|
|
|
# Use /var/lib/ntfy/user.db as user database to avoid permission issues. The package
|
|
|
|
# creates this folder for you.
|
|
|
|
#
|
|
|
|
# Check your permissions:
|
|
|
|
# If you are running ntfy with systemd, make sure this user database file is owned by the
|
|
|
|
# ntfy user and group by running: chown ntfy.ntfy <filename>.
|
|
|
|
#
|
|
|
|
# auth-file: <filename>
|
|
|
|
# auth-default-access: "read-write"
|
2023-01-29 21:11:26 +01:00
|
|
|
# auth-startup-queries:
|
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
|
|
|
|
|
2022-01-13 21:17:30 +01:00
|
|
|
# If enabled, clients can attach files to notifications as attachments. Minimum settings to enable attachments
|
|
|
|
# are "attachment-cache-dir" and "base-url".
|
|
|
|
#
|
|
|
|
# - attachment-cache-dir is the cache directory for attached files
|
|
|
|
# - attachment-total-size-limit is the limit of the on-disk attachment cache directory (total size)
|
|
|
|
# - attachment-file-size-limit is the per-file attachment size limit (e.g. 300k, 2M, 100M)
|
|
|
|
# - attachment-expiry-duration is the duration after which uploaded attachments will be deleted (e.g. 3h, 20h)
|
|
|
|
#
|
|
|
|
# attachment-cache-dir:
|
|
|
|
# attachment-total-size-limit: "5G"
|
|
|
|
# attachment-file-size-limit: "15M"
|
|
|
|
# attachment-expiry-duration: "3h"
|
|
|
|
|
2021-12-27 22:27:01 +01:00
|
|
|
# If enabled, allow outgoing e-mail notifications via the 'X-Email' header. If this header is set,
|
|
|
|
# messages will additionally be sent out as e-mail using an external SMTP server. As of today, only
|
|
|
|
# SMTP servers with plain text auth and STARTLS are supported. Please also refer to the rate limiting settings
|
2021-12-25 00:57:02 +01:00
|
|
|
# below (visitor-email-limit-burst & visitor-email-limit-burst).
|
|
|
|
#
|
2021-12-27 22:27:01 +01:00
|
|
|
# - smtp-sender-addr is the hostname:port of the SMTP server
|
|
|
|
# - smtp-sender-user/smtp-sender-pass are the username and password of the SMTP user
|
|
|
|
# - smtp-sender-from is the e-mail address of the sender
|
2021-12-25 00:57:02 +01:00
|
|
|
#
|
2021-12-27 22:27:01 +01:00
|
|
|
# smtp-sender-addr:
|
|
|
|
# smtp-sender-user:
|
|
|
|
# smtp-sender-pass:
|
|
|
|
# smtp-sender-from:
|
2021-12-25 00:57:02 +01:00
|
|
|
|
2021-12-28 17:36:12 +01:00
|
|
|
# If enabled, ntfy will launch a lightweight SMTP server for incoming messages. Once configured, users can send
|
|
|
|
# emails to a topic e-mail address to publish messages to a topic.
|
|
|
|
#
|
|
|
|
# - smtp-server-listen defines the IP address and port the SMTP server will listen on, e.g. :25 or 1.2.3.4:25
|
|
|
|
# - smtp-server-domain is the e-mail domain, e.g. ntfy.sh
|
|
|
|
# - smtp-server-addr-prefix is an optional prefix for the e-mail addresses to prevent spam. If set to "ntfy-",
|
|
|
|
# for instance, only e-mails to ntfy-$topic@ntfy.sh will be accepted. If this is not set, all emails to
|
|
|
|
# $topic@ntfy.sh will be accepted (which may obviously be a spam problem).
|
|
|
|
#
|
2021-12-27 16:39:28 +01:00
|
|
|
# smtp-server-listen:
|
2021-12-27 22:27:01 +01:00
|
|
|
# smtp-server-domain:
|
|
|
|
# smtp-server-addr-prefix:
|
2021-12-27 16:39:28 +01:00
|
|
|
|
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.
|
|
|
|
#
|
2022-01-15 19:23:35 +01:00
|
|
|
# keepalive-interval: "45s"
|
2021-10-29 20:03:41 +02:00
|
|
|
|
2021-11-05 18:46:27 +01:00
|
|
|
# Interval in which the manager prunes old messages, deletes topics
|
|
|
|
# and prints the stats.
|
2021-10-29 20:03:41 +02:00
|
|
|
#
|
2022-01-13 21:17:30 +01:00
|
|
|
# manager-interval: "1m"
|
2021-11-05 18:46:27 +01:00
|
|
|
|
2023-02-09 14:32:51 +01:00
|
|
|
# Defines topic names that are not allowed, because they are otherwise used. There are a few default topics
|
|
|
|
# that cannot be used (e.g. app, account, settings, ...). To extend the default list, define them here.
|
|
|
|
#
|
|
|
|
# Example:
|
|
|
|
# disallowed-topics:
|
|
|
|
# - about
|
|
|
|
# - pricing
|
|
|
|
# - contact
|
|
|
|
#
|
|
|
|
# disallowed-topics:
|
|
|
|
|
2022-03-06 03:28:25 +01:00
|
|
|
# Defines if the root route (/) is pointing to the landing page (as on ntfy.sh) or the
|
2022-05-13 19:08:07 +02:00
|
|
|
# web app. If you self-host, you don't want to change this.
|
2022-05-13 20:42:25 +02:00
|
|
|
# Can be "app" (default), "home" or "disable" to disable the web app entirely.
|
2022-03-06 03:28:25 +01:00
|
|
|
#
|
|
|
|
# web-root: app
|
|
|
|
|
2023-01-12 18:04:18 +01:00
|
|
|
# Various feature flags used to control the web app, and API access, mainly around user and
|
|
|
|
# account management.
|
|
|
|
#
|
|
|
|
# - enable-signup allows users to sign up via the web app, or API
|
|
|
|
# - enable-login allows users to log in via the web app, or API
|
|
|
|
# - enable-reservations allows users to reserve topics (if their tier allows it)
|
|
|
|
#
|
|
|
|
# enable-signup: false
|
|
|
|
# enable-login: false
|
|
|
|
# enable-reservations: false
|
|
|
|
|
2022-05-28 02:30:20 +02:00
|
|
|
# Server URL of a Firebase/APNS-connected ntfy server (likely "https://ntfy.sh").
|
|
|
|
#
|
|
|
|
# iOS users:
|
|
|
|
# If you use the iOS ntfy app, you MUST configure this to receive timely notifications. You'll like want this:
|
|
|
|
# upstream-base-url: "https://ntfy.sh"
|
|
|
|
#
|
|
|
|
# If set, all incoming messages will publish a "poll_request" message to the configured upstream server, containing
|
|
|
|
# the message ID of the original message, instructing the iOS app to poll this server for the actual message contents.
|
|
|
|
# This is to prevent the upstream server and Firebase/APNS from being able to read the message.
|
|
|
|
#
|
|
|
|
# upstream-base-url:
|
|
|
|
|
2021-11-05 18:46:27 +01:00
|
|
|
# Rate limiting: Total number of topics before the server rejects new topics.
|
|
|
|
#
|
2022-01-13 00:52:07 +01:00
|
|
|
# global-topic-limit: 15000
|
2021-11-05 18:46:27 +01:00
|
|
|
|
|
|
|
# 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
|
2022-11-12 20:41:28 +01:00
|
|
|
# - visitor-request-limit-exempt-hosts is a comma-separated list of hostnames, IPs or CIDRs to be
|
|
|
|
# exempt from request rate limiting. Hostnames are resolved at the time the server is started.
|
|
|
|
# Example: "1.2.3.4,ntfy.example.com,8.7.6.0/24"
|
2021-11-05 18:46:27 +01:00
|
|
|
#
|
|
|
|
# visitor-request-limit-burst: 60
|
2022-02-14 23:07:17 +01:00
|
|
|
# visitor-request-limit-replenish: "5s"
|
|
|
|
# visitor-request-limit-exempt-hosts: ""
|
2021-11-05 18:46:27 +01:00
|
|
|
|
2023-01-27 04:57:18 +01:00
|
|
|
# Rate limiting: Hard daily limit of messages per visitor and day. The limit is reset
|
|
|
|
# every day at midnight UTC. If the limit is not set (or set to zero), the request
|
|
|
|
# limit (see above) governs the upper limit.
|
|
|
|
#
|
|
|
|
# visitor-message-daily-limit: 0
|
|
|
|
|
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
|
2022-01-13 21:17:30 +01:00
|
|
|
# visitor-email-limit-replenish: "1h"
|
|
|
|
|
|
|
|
# Rate limiting: Attachment size and bandwidth limits per visitor:
|
|
|
|
# - visitor-attachment-total-size-limit is the total storage limit used for attachments per visitor
|
|
|
|
# - visitor-attachment-daily-bandwidth-limit is the total daily attachment download/upload traffic limit per visitor
|
|
|
|
#
|
|
|
|
# visitor-attachment-total-size-limit: "100M"
|
|
|
|
# visitor-attachment-daily-bandwidth-limit: "500M"
|
2022-06-01 22:57:35 +02:00
|
|
|
|
2023-01-16 22:35:37 +01:00
|
|
|
# Payments integration via Stripe
|
|
|
|
#
|
|
|
|
# - stripe-secret-key is the key used for the Stripe API communication. Setting this values
|
|
|
|
# enables payments in the ntfy web app (e.g. Upgrade dialog). See https://dashboard.stripe.com/apikeys.
|
|
|
|
# - stripe-webhook-key is the key required to validate the authenticity of incoming webhooks from Stripe.
|
|
|
|
# Webhooks are essential up keep the local database in sync with the payment provider. See https://dashboard.stripe.com/webhooks.
|
2023-02-28 20:38:31 +01:00
|
|
|
# - billing-contact is an email address or website displayed in the "Upgrade tier" dialog to let people reach
|
|
|
|
# out with billing questions. If unset, nothing will be displayed.
|
2023-01-16 22:35:37 +01:00
|
|
|
#
|
|
|
|
# stripe-secret-key:
|
|
|
|
# stripe-webhook-key:
|
2023-02-28 20:38:31 +01:00
|
|
|
# billing-contact:
|
2023-01-16 22:35:37 +01:00
|
|
|
|
2023-02-09 04:57:10 +01:00
|
|
|
# Logging options
|
|
|
|
#
|
2023-02-14 19:58:49 +01:00
|
|
|
# By default, ntfy logs to the console (stderr), with an "info" log level, and in a human-readable text format.
|
2023-02-09 04:57:10 +01:00
|
|
|
# ntfy supports five different log levels, can also write to a file, log as JSON, and even supports granular
|
|
|
|
# log level overrides for easier debugging. Some options (log-level and log-level-overrides) can be hot reloaded
|
|
|
|
# by calling "kill -HUP $pid" or "systemctl reload ntfy".
|
|
|
|
#
|
|
|
|
# - log-format defines the output format, can be "text" (default) or "json"
|
|
|
|
# - log-file is a filename to write logs to. If this is not set, ntfy logs to stderr.
|
|
|
|
# - log-level defines the default log level, can be one of "trace", "debug", "info" (default), "warn" or "error".
|
|
|
|
# Be aware that "debug" (and particularly "trace") can be VERY CHATTY. Only turn them on briefly for debugging purposes.
|
|
|
|
# - log-level-overrides lets you override the log level if certain fields match. This is incredibly powerful
|
|
|
|
# for debugging certain parts of the system (e.g. only the account management, or only a certain visitor).
|
2023-02-10 02:49:45 +01:00
|
|
|
# This is an array of strings in the format:
|
|
|
|
# - "field=value -> level" to match a value exactly, e.g. "tag=manager -> trace"
|
|
|
|
# - "field -> level" to match any value, e.g. "time_taken_ms -> debug"
|
2023-02-09 04:57:10 +01:00
|
|
|
# Warning: Using log-level-overrides has a performance penalty. Only use it for temporary debugging.
|
|
|
|
#
|
|
|
|
# Example (good for production):
|
|
|
|
# log-level: info
|
|
|
|
# log-format: json
|
|
|
|
# log-file: /var/log/ntfy.log
|
|
|
|
#
|
|
|
|
# Example level overrides (for debugging, only use temporarily):
|
|
|
|
# log-level-overrides:
|
|
|
|
# - "tag=manager -> trace"
|
|
|
|
# - "visitor_ip=1.2.3.4 -> debug"
|
2023-02-10 02:49:45 +01:00
|
|
|
# - "time_taken_ms -> debug"
|
2022-06-02 05:24:44 +02:00
|
|
|
#
|
2023-02-06 05:34:27 +01:00
|
|
|
# log-level: info
|
|
|
|
# log-level-overrides:
|
|
|
|
# log-format: text
|
|
|
|
# log-file:
|