pingd docs

Releases

Binaries and container images for each release are on the GitHub releases page and GHCR.

pingd v0.2.0 (UNRELEASED)

Features:

  • placeholder, describe next user-visible feature

Bug fixes:

  • placeholder

Documentation:

  • placeholder

pingd v0.1.0 (2026-05-05)

Initial public release. Self-hosted push notification relay over HTTP, written in Swift on Vapor with a single SQLite file for storage.

Features:

  • Topics with independent publicRead and publicPublish access flags
  • NATS-style permission patterns (alerts.>, deploy.*) with ro / wo / rw / deny
  • Per-delivery row tracking with retry semantics and TTL-aware expiry
  • Per-topic message history queryable from dashboard, CLI, and HTTP endpoints
  • Web Push (VAPID) and APNS (direct + relay modes) push channels
  • Webhook ingress with {{path.to.field}} template rendering, scoped per topic
  • Server-Sent Events (/topics/:name/stream) for live tailing
  • Bearer-token auth, guest sessions, and per-topic share tokens
  • pingd-cli for topics, messages, users, tokens, permissions, shares, webhooks
  • Static dashboard at / for end users

Operations:

  • Single binary, single SQLite file, single port (default 7685)
  • Docker image at ghcr.io/saeid/pingd:latest, multi-arch amd64 + arm64
  • /health endpoint for orchestrators

Documentation:

  • Initial docs site covering install, getting started, config, publishing, subscribing, topics, permissions, users & tokens, webhooks, web push, APNS, examples, releases, FAQ