Notir – A Minimal Web Notification Service via HTTP and WebSocket

Hi Devs 👋

I recently built Notir — a lightweight, self-hostable real-time notification service. It delivers messages over WebSocket with no database, no authentication, and no complex setup.

🔧 How It Works

Clients (like browsers) open a WebSocket connection with a unique id:

ws://localhost:5800/ws?id=your-unique-id

Any HTTP POST to /pub?id=your-unique-id sends the message to all connected WebSocket clients with that ID:

POST /pub?id=your-unique-id

✅ No database required
✅ No authentication
✅ No third-party services
✅ Docker-ready

🚀 Live Demo

Give it a try in 3 steps:

Step 1: Open in browser http://notir.fornetcode.com:5800/?id=theUniqueId_ChangeIt

Step 2: Open browser developer console

Step 3: Send a message using curl

curl -X POST http://notir.fornetcode.com:5800/pub?id=theUniqueId_ChangeIt -d "Hello World"

🎉 Message delivered instantly to the browser.

📦 Quick Start for Self-Hosted

docker run -it --rm -p 5800:5800 ghcr.io/timzaak/notir:latest

🔗 Project Page

GitHub: https://github.com/timzaak/notir

I’d love your feedback, ideas, or contributions — feel free to star or open an issue!

Thanks for reading!