🚀 Getting Started
This guide takes you from zero to a fully working ntfybridge: embedded ntfy server, external access, Family Chat installed on your phone and first successful test.
Step 1 — Install the Plugin
Plugins → Plugin Management → Market → ntfybridge → Install
Activate the plugin after installation, then click Relaunch in the Dependencies section to automatically install Node.js ≥ 22 and the ntfy binary.
Dependency installation takes 2 to 5 minutes. Wait for the status to show OK before continuing.
Step 2 — Configure the ntfy Server
Plugins → Plugin Management → ntfybridge → Configuration
| Field | Value |
|---|---|
| Mode | Embedded |
| Admin Username | Editable (default: ntfyadmin) — change before the first start only |
| ntfy Port | Leave empty — auto-detected on save |
The ntfy admin account password is generated automatically at installation (32 random characters). It is not visible in the interface — it is an internal account used by the plugin. You do not need to remember it. To create user accounts accessible from the ntfy app or Family Chat, use the Panel (step 4).
Click Save, then Relaunch the daemon. The ntfy server starts with the daemon.
The daemon status should show OK. If not, check the ntfybridge logs to diagnose.
Step 3 — Expose ntfy
For the ntfy app and Family Chat to work from outside (and for native iOS push), ntfy must be accessible over HTTPS.
- ⭐ Via Tailscale (recommended if no fixed IPv4)
- Via subdomain (universal access)
No ports to open, automatic HTTPS, zero DNS configuration.
The easiest way to install and manage Tailscale on your Jeedom server is to use the Tailscale plugin — it installs Tailscale, handles authentication and configures tailscale serve from the Jeedom interface, without any command line.
Prerequisites: Tailscale active on your Jeedom server and the Tailscale app installed on your devices.
- In the plugin configuration, click Tailscale Wizard
- Follow the 3 steps:
- Detection — the wizard checks that Tailscale is active and reads your Tailscale domain name (e.g.
jeedom.mydomain.ts.net) - Configuration — configures
tailscale serveto expose ntfy on port 8443 - Validation — tests the HTTPS URL and automatically updates the Public URL field
- Detection — the wizard checks that Tailscale is active and reads your Tailscale domain name (e.g.
- Click Save
The public URL will then be of the form https://jeedom.mydomain.ts.net:8443.
Only devices in your Tailscale network can access ntfy. This is sufficient for family use on managed devices.
Accessible from any device and network, native iOS push included.
Prerequisites: a domain name and ports 80/443 open on your internet router.
- Open ports 80 (HTTP) and 443 (HTTPS) towards your Jeedom IP on your router
- In the plugin configuration, click Reverse Proxy Wizard
- Follow the 5 steps — the wizard generates the configuration for Apache, Nginx, NPM, Traefik or Cloudflare
- Apply the configuration in the terminal following the displayed instructions
- Enter the Public URL (e.g.
https://ntfy.mydomain.com) and Save
sudo certbot renew --dry-run
Step 4 — Create a User
On the plugin main page.
- Click Add User
- Enter a username and password (minimum 8 characters)
- Click Create
- In the permissions table, assign read-write on the topics this user should access
Create a separate account for each household member — this lets you control rights per topic and identify the sender in Family Chat.
Step 5 — Choose Your Client
- 💬 Family Chat (household messaging)
- 🔔 Official ntfy app (home automation notifications)
Family Chat is a PWA built into the plugin — no download required.
Install on the Home Screen
The chat URL depends on how you exposed ntfy in step 3:
| Method | Chat URL |
|---|---|
| Tailscale (chat exposed via the wizard) | https://debian13.xxx.ts.net:8443/chat/ |
| Subdomain | https://jeedom.yourdomain.com/plugins/ntfybridge/chat/ |
The exact URL is displayed in the plugin configuration after running the Tailscale wizard or the reverse proxy wizard.
- 🍎 iOS
- 🤖 Android
- Open Safari → chat URL (see table above)
- Tap Share → Add to Home Screen
- Name the app (e.g. Family) → Add
- Open from the icon — push notifications only work from the home screen
- Open Chrome → chat URL (see table above)
- Menu ⋮ → Install app
Log In
On first launch:
| Field | Value |
|---|---|
| Server | Pre-filled automatically (public URL configured in step 3) |
| User | Account created in step 4 |
| Password | Account password |
Add a Room
- Tap + in the room bar
- Enter a display name and an ntfy topic (e.g.
family) - Make sure the user has read-write rights on this topic in the panel
Enable Push Notifications
- Open Settings (⚙) → enable Notifications
- Allow in the browser
- Per room: ⋯ menu → Notifications to enable/disable room by room
The official ntfy app is ideal for receiving Jeedom alerts and replying by message.
Download
| Platform | Link |
|---|---|
| iOS | App Store |
| Android | Google Play or F-Droid |
Subscribe to a Topic
- Open the app → +
- Enter the full topic URL:
https://ntfy.yourdomain.com/my_topic - Enter the username and password created in step 4
The exact URL is displayed in the Subscription section of each ntfybridge equipment — you can copy it directly.
Step 6 — First Test
Test Ping (rescue mode)
From the ntfy app or Family Chat, send ping on the configured rescue topic.
Jeedom should respond with the server time, CPU load and uptime.
Test a Jeedom Notification
In a scenario or from the Jeedom console:
Action → Message → [your ntfybridge equipment] Send Message
Title : Test
Message : Hello from Jeedom!
The notification should appear on your phone within a few seconds.
- Create your response rules — Jeedom automatically answers your questions → see Responses
- Configure rescue mode to control Jeedom even if the web interface is down → see Rescue Mode
- Explore send profiles to group priority, tags and icon → see Profiles