Startpagina/Artikel
Esadax JournalApps

ntfy

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

ntfy logo

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_64 of amd64
  • armv7 of armhf
  • arm64 (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.nix en voer nixos-rebuild switch uit.
  • 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

  1. Download de ZIP van GitHub Releases.
  2. Pak ntfy.exe uit en plaats het in uw %Path% (bijvoorbeeld C:\Program Files\).

Voer commando's uit zoals:

ntfy.exe -h

Als Windows-service

  1. 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) of sudo 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.yml of Docker run command (-p 8080:80).

Configuratiebestanden

  • Client Config: /etc/ntfy/client.yml (of ~/.config/ntfy/client.yml voor 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.

Abonneren