← Complete project index

Infrastructure & Operations / Built / deployed

Private Alert Delivery

Self-hosted ntfy alert path from Alertmanager to a private Tailscale HTTPS endpoint with isolated publisher/subscriber identities and no public push dependency.

STATUSBuilt / deployed
AREAInfrastructure & Operations
STACK5 documented technologies
INTEGRATIONS3 connected / bounded services
01

OVERVIEW

What I built.

Self-hosted ntfy alert path from Alertmanager to a private Tailscale HTTPS endpoint with isolated publisher/subscriber identities and no public push dependency.

01

Built a self-hosted ntfy notification path for infrastructure alerts.

02

Created separate write-only alert publisher and read-only client identities.

03

Kept delivery private over Tailscale HTTPS with no dependency on ntfy.sh, public Funnel, Telegram or SMTP.

02

SYSTEM ARCHITECTURE

How the system is divided.

01
Architecture boundary

Prometheus -> Alertmanager -> private ntfy -> Tailscale Serve HTTPS -> phone/client.

02
Architecture boundary

Persistent auth/cache state remains local and is included only in encrypted DR.

03
Architecture boundary

Alert severity maps to ntfy priority while firing/resolved states remain visible.

03

NETWORK / DATA FLOW

What talks to what.

04

TECHNOLOGY STACK

The technical surface.

01ntfy
02Alertmanager
03Tailscale
04TLS
05Docker
05

IMPLEMENTATION

How it works in practice.

  1. 01

    Prometheus -> Alertmanager -> private ntfy -> Tailscale Serve HTTPS -> phone/client.

  2. 02

    Persistent auth/cache state remains local and is included only in encrypted DR.

  3. 03

    Alert severity maps to ntfy priority while firing/resolved states remain visible.

06

TESTING & VALIDATION

How I know it works.

TEST 01

ntfy health

TEST 02

Publisher/subscriber ACL behavior

TEST 03

Alertmanager delivery

TEST 04

Firing/resolved formatting

TEST 05

Tailscale private HTTPS path

TEST 06

LAN fallback health

07

EXTERNAL SERVICES & DEPENDENCIES

What sits outside the core.

COREPrivate Alert Delivery
08

ENGINEERING EVIDENCE

Artifacts behind the claims.

01ntfy compose/config
02Alert formatting template
03Publisher identity
04Read-only client identity
05Persistent auth/cache state
09

BOUNDARIES / CONSTRAINTS

What the project does not pretend to solve.

No anonymous access

No ntfy.sh/APNS upstream

Funnel remains disabled

Auth/cache database is treated as sensitive state

10

RESULT / CURRENT STATE

What this produced.

A private mobile alert channel that remains under local operational control.