A server to send notifications triggered by time, events, etc from your various systems.
What you'll need
- (Optional but recommended) A domain name with an A-record pointed to your public IP
- (Optional but recommended) NGinX Proxy Manager, or reverse proxy of your choice
- About 20 minutes of your time
Installation of Docker-CE, Docker-Compose, and NGinX Proxy Manager via a Simple Script
You can easily install Docker-CE, Docker-Compose, Portainer-CE, and NGinX Proxy manager by using this quick install script I created and maintain on Github. Just use the command:
wget -O install-docker.sh https://gitlab.com/bmcgonag/docker_installs/-/raw/main/install_docker_nproxyman.sh
To download the script to your desired host.
Change the permissions to make the script executable:
chmod +x ./install_docker.sh
and then run the script with the command:
When run, the script will prompt you to select your host operating system, then will ask you which bits of software you want to install.
Simply enter 'y' for each thing you want to install.
At some point, you may be asked for your super user (sudo) password as well.
Allow the script to complete installation.
At this point, you might want to log out and back in, as this will allow you to use the
docker-compose commands without the need of sudo in front of them.
Install Ntfy.sh Using Docker:
Create a new folder inside your parent docker folder.
mkdir -p docker/ntfy-server
Move into the new folder
Create a new file called "docker-compose.yml" in this folder
Paste the following code-block into that folder:
version: "2.3" services: ntfy: image: binwiederhier/ntfy container_name: ntfy-server command: - serve environment: - TZ=America/Chicago # optional: set desired timezone volumes: - ./var/cache/ntfy:/var/cache/ntfy - ./etc/ntfy:/etc/ntfy ports: - 8150:80 healthcheck: # optional: remember to adapt the host:port to your environment test: ["CMD-SHELL", "wget -q --tries=1 http://localhost:8150/v1/health -O - | grep -Eo '\"healthy\"\\s*:\\s*true' || exit 1"] interval: 60s timeout: 10s retries: 3 start_period: 40s restart: unless-stopped
Save the file with CTRL + O, press Enter to confirm. Check over the file contents once more to make sure you've adjusted parameters appropriately for your system, then exit the nano text editor with CTRL + X.
Now, run the file with the command
docker compose up -d && docker compose logs -f
In the above command combination, we have 2 commands separated by the ‘&&’ symbol, which means run the second command as soon as the first command completes.
docker compose up -d says, pull down the images, and start the container running according to the parameters provided in my docker-compose.yml file.
docker compose logs -f says, show me the running log output of the container as it's being brought up and running.
You can stop seeing the logs at any time by using the CTRL + C hotkey combination.
After the site is up and running, you'll likely want to add a domain name to it.
You'll need to own the domain name, and be able to set the A-record (or a CNAME) for it to point to your public IP. Then you can use a reverse proxy to get the Domain to your server, and get an SSL certificate for https.
This is important if you want push notifications to remotely work for an iOS device.
Once you've setup your reverse proxy and everything is working, you'll need to add a server.yml file to your setup.
You'll want to add a file to the folder that is created here:
The contents shoudl be
base-url: "https://ntfyserv.youdomain.com" upstream-base-url: "https://ntfy.sh" attachment-cache-dir: "/home/youruser/docker/ntfy-server/var/cache/ntfy/attachments"
The base-url needs to match the url you set for your server, and match the url you enter as the default server in the iOS app.
The upstream-base-url needs to be “https://ntfy.sh”, even if you host your own server.
Save the file, and do the following commands:
docker compose down
docker compose up -d
Now publish a message to your server, either through the web interface, or through a command line command.
Subscribe to the topic on your server web ui and your mobile device.
You should receive the message you publish.
Now, you should also be able to post / put to your server from other devices. You can try it out from the command line using
-d option for
curl will do a post / put to an API endpoint. The
-L option tells the
curl command to follow the redirects to our SSL encrypted page. So we can use a command like:
curl -d “Some kind of useful test message here” -L https://myserver.mydomain.com/myTopic
You should then receive the message on any device you have subscribed to “myTopic”.
The format for the curl command is:
curl [option -d] “message text” [option -L] https://yourserver.url/<topic-name>
Support My Channel and Content
Support my Channel and ongoing efforts through Patreon: