ntfy Server Installatiehandleiding
Deze handleiding bevat instructies voor het installeren van de ntfy-server op verschillende Linux-distributies, evenals andere besturingssystemen. ntfy is een eenvoudige HTTP-gebaseerde pub-sub meldingsdienst.
Voorwaarden
- Een Linux systeem (of een ander ondersteund besturingssysteem)
- Root-toegang of sudo-rechten
- Een internetverbinding om binaries en pakketten te downloaden
1.1. Handmatige installatie vanaf de broncode (Binaire tarballs)
Deze methode werkt op elke Linux-distributie die de specifieke architectuur van uw systeem ondersteunt.
Stap 1: Identificeer uw architectuur
Voer uname -m uit om uw architectuur te controleren:
x86_64ofamd64armv7ofarmhfarm64(aarch64)armv6
Stap 2: Download en pak het binaire bestand uit
Voorbeeld voor x86_64/amd64:
wget https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_linux_amd64.tar.gz
tar zxvf ntfy_2.28.0_linux_amd64.tar.gz
Voorbeeld voor armv7/armhf:
wget https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_linux_armv7.tar.gz
tar zxvf ntfy_2.28.0_linux_armv7.tar.gz
Voorbeeld voor arm64:
wget https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_linux_arm64.tar.gz
tar zxvf ntfy_2.28.0_linux_arm64.tar.gz
Stap 3: Installeer de binaire en configuratiebestanden
# Copy the binary to /usr/bin
sudo cp -a <architecture>/ntfy /usr/bin/ntfy
# Create config directory and copy files
sudo mkdir -p /etc/ntfy
sudo cp <architecture>/client/client.yml /etc/ntfy/
sudo cp <architecture>/server/server.yml /etc/ntfy/
Stap 4: Start de server
sudo ntfy serve
2. Installeer als een systeemdienst (Systemd)
Als je wilt dat de server automatisch start bij het opstarten, gebruik dan systemd.
Voorwaarden
- Zorg ervoor dat uw besturingssysteem systemd gebruikt (
systemctl --version). - U moet de binaire en configuratiebestanden hebben geïnstalleerd in stap 1 hierboven.
Stappen
Controleer de status:
sudo systemctl status ntfy
Laad Systemd opnieuw en start de service:
sudo systemctl daemon-reload
sudo systemctl enable ntfy
sudo systemctl start ntfy
Kopieer het Service Unit bestand:
# Replace <architecture> with your system's architecture (e.g., amd64, armv7)
sudo mv <architecture>/server/ntfy.service /etc/systemd/system/
sudo chmod 644 /etc/systemd/system/ntfy.service
Drie. Installeer als een systeemdienst (OpenRC)
Voor systemen die OpenRC gebruiken (bijv. Alpine Linux, Gentoo).
Stappen
Toevoegen aan standaard runlevel (om te starten bij het opstarten):
sudo rc-update add ntfy default
Start de Service:
sudo rc-service ntfy start
Kopieer het Service Script:
# Replace <architecture> with your system's architecture
sudo mv <architecture>/server/ntfy.openrc /etc/init.d/ntfy
sudo chmod 755 /etc/init.d/ntfy
4.3 Contra-indicaties Installatie via pakketbronnen
Debian en Ubuntu
Opmerking: Vanaf eind 2025 is de officiële repository verhuisd naar archive.ntfy.sh. De oude (heckel.io) is verouderd.
APT gebruiken (Aanbevolen)
# Add keyring
sudo mkdir -p /etc/apt/keyrings
sudo curl -L -o /etc/apt/keyrings/ntfy.gpg https://archive.ntfy.sh/apt/keyring.gpg
sudo apt install apt-transport-https
# Add repository
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/ntfy.gpg] https://archive.ntfy.sh/apt stable main" | sudo tee /etc/apt/sources.list.d/ntfy.list
# Update and Install
sudo apt update
sudo apt install ntfy
Handmatige.deb installatie
wget https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_linux_amd64.deb
sudo dpkg -i ntfy_*.deb
sudo systemctl enable ntfy
sudo systemctl start ntfy
Fedora / RHEL / CentOS
# Install RPM
sudo rpm -ivh https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_linux_amd64.rpm
# Enable and Start
sudo systemctl enable ntfy
sudo systemctl start ntfy
Wat is Arch Linux?
AUR Helper gebruiken (Aanbevolen)
paru -S ntfysh-bin
Handleiding voor installatie
curl https://aur.archlinux.org/cgit/aur.git/snapshot/ntfysh-bin.tar.gz | tar xzv
cd ntfysh-bin
makepkg -si
NixOS / Nix
- NixOS Configuratie: Voeg
services.ntfy-sh.enable = true;toe aan je/etc/nixos/configuration.nixen voernixos-rebuild switchuit. - Gebruikersomgeving:
nix-env -iA ntfy-sh
FreeBSD
pkg install go-ntfy
Vijf. Installatie van macOS
macOS ondersteunt de CLI (ntfy publish, ntfy subscribe) maar ondersteunt de server niet via officiële pakketten.
Handmatige CLI-installatie
curl -L https://github.com/binwiederhier/ntfy/releases/download/v2.28.0/ntfy_2.28.0_darwin_all.tar.gz > ntfy.tar.gz
tar zxvf ntfy.tar.gz
sudo cp -a ntfy_2.28.0_darwin_all/ntfy /usr/local/bin/ntfy
mkdir ~/Library/Application\ Support/ntfy
cp ntfy_2.28.0_darwin_all/client/client.yml ~/Library/Application\ Support/ntfy/client.yml
Opmerking: Als u de server op macOS wilt uitvoeren, moet u deze handmatig bouwen met Go (zie Instructies voor bouwen).
- Zes. Installatie van Homebrew
brew install ntfy
Hiermee wordt alleen de CLI geïnstalleerd. Serverinstallatie vereist handmatige stappen.
Zeven. Installatie van Windows
Als een gebruikersprogramma
- Download de ZIP van GitHub Releases.
- Pak
ntfy.exeuit en plaats het in uw%Path%(bijvoorbeeldC:\Program Files\).
Voer commando's uit zoals:
ntfy.exe -h
Als Windows-service
- Open een verhoogde opdrachtprompt.
Start de service:
sc start ntfy
Maak de service aan:
sc create ntfy binPath="C:\path\to\ntfy.exe serve" start=auto
Acht. Installatie van Docker
Basisgebruik (geen permanente cache)
docker run -p 80:80 -it binwiederhier/ntfy serve
Met permanente cache
docker run \
-v /var/cache/ntfy:/var/cache/ntfy \
-p 80:80 \
-it \
binwiederhier/ntfy \
serve \
--cache-file /var/cache/ntfy/cache.db
Met Custom Config (Niet-root gebruiker)
docker run \
-v /etc/ntfy:/etc/ntfy \
-e TZ=UTC \
-p 80:80 \
-u UID:GID \
-it \
binwiederhier/ntfy \
serve
Voorbeeld van Docker Compose
version: '3'
services:
ntfy:
image: binwiederhier/ntfy
container_name: ntfy
command: ["serve"]
environment:
- TZ=UTC
user: "1000:1000" # Replace with your UID/GID
volumes:
- /var/cache/ntfy:/var/cache/ntfy
- /etc/ntfy:/etc/ntfy
ports:
- "80:80"
healthcheck:
test: ["CMD-SHELL", "wget -q --tries=1 http://localhost:80/v1/health -O - | grep -Eo '\"healthy\"\\s*:\\s*true' || exit 1"]
interval: 60s
timeout: 10s
retries: 3
start_period: 40s
restart: unless-stopped
init: true
9.1.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2 Implementatie van Kubernetes (K8s)
StatefulSet met permanente cache
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: ntfy
spec:
serviceName: ntfy
replicas: 1
selector:
matchLabels:
app: ntfy
template:
metadata:
labels:
app: ntfy
spec:
containers:
- name: ntfy
image: binwiederhier/ntfy
args: ["serve", "--cache-file", "/var/cache/ntfy/cache.db"]
ports:
- containerPort: 80
name: http
volumeMounts:
- name: config
mountPath: /etc/ntfy
readOnly: true
- name: cache
mountPath: /var/cache/ntfy
volumes:
- name: config
configMap:
name: ntfy
- name: cache
persistentVolumeClaim:
claimName: ntfy-cache
---
apiVersion: v1
kind: Service
metadata:
name: ntfy
spec:
selector:
app: ntfy
ports:
- port: 80
targetPort: 80
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: ntfy-cache
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 1Gi
Problemen oplossen
- Service niet gestart: Controleer logs met
sudo journalctl -u ntfy(systemd) ofsudo rc-service ntfy status(OpenRC). - Toestemming geweigerd: Zorg ervoor dat de binaire en configuratiebestanden eigendom zijn van root of een specifieke gebruiker als deze niet als root wordt uitgevoerd.
- Poort al in gebruik: Wijzig de poort in
server.ymlof Docker run command (-p 8080:80).
Configuratiebestanden
- Client Config:
/etc/ntfy/client.yml(of~/.config/ntfy/client.ymlvoor niet-root). - Serverconfiguratie:
/etc/ntfy/server.yml.
Bewerk deze bestanden om instellingen aan te passen, zoals tijdzone, maximale berichtgrootte of bewaarbeleid.
Opmerkingen over beveiliging
- Voer ntfy indien mogelijk altijd uit als een niet-rootgebruiker in productie (configureer via
user-vlag in Docker of systemd-service). - Zorg ervoor dat de webgebruikersinterface alleen toegankelijk is via vertrouwde netwerken als deze openbaar is.
- Werk uw installatie regelmatig bij om beveiligingsproblemen op te lossen.
Ga voor meer informatie naar de ntfy GitHub Repository.
Parameters van de configuratie
Na aankoop van deze applicatie op Esadax, wordt u gevraagd om de onderstaande configuratieparameters op te geven. Esadax voegt de aangeleverde variabelen toe aan de deployment zodat de applicatie gestart kan worden met de configuratie die nodig is.
| Parameter | Beschrijving |
|---|---|
ADMIN_USERNAME |
Waarde die aan de implementatie is geleverd voor ADMIN_USERNAME. |
ADMIN_PASSWORD |
Waarde die aan de implementatie is geleverd voor ADMIN_PASSWORD. |
Zodra de waarden zijn geconfigureerd, klikt u op Deploy om de toepassing te starten. De aangeschafte toepassing gebruikt de meegeleverde configuratiewaarden, inclusief referenties zoals gebruikersnamen en wachtwoorden wanneer die parameters worden verstrekt.

