Gotify is a self-hosted push notification service that allows you to send notifications to your devices using an API. In this tutorial, we will install the Gotify server on OpenBSD.
Before we begin, you need to make sure that you have the following prerequisites in place:
Go is a programming language used to build Gotify. To install Go, run the following command in your terminal:
# pkg_add go
Now that we have installed Go, we can go ahead and download Gotify. To do this, we need to clone the Gotify source code from GitHub.
$ git clone https://github.com/gotify/server.git
$ cd server
Once you are inside the Gotify directory, run the following command to build the server:
$ go build
When the build process completes, you will see that there is a newly created binary file named server. To install the Gotify server, run the following command:
# install server /usr/local/bin/
To configure Gotify, we need to create a configuration file. You can use the example configuration file provided in the Gotify repository as a starting point:
$ cp config-example.yml config.yml
Now open the configuration file with your text editor of choice and make the necessary adjustments. Most importantly, you should set a secure password and secret for your server. Once you are done, save and close the file.
With our configuration file in place, we can now start the Gotify server. To do this, run the following command:
# gotify serve -c /path/to/config.yml
Replace /path/to/config.yml with the actual path to your configuration file.
If everything goes well, you should see a message indicating that the Gotify server is running.
To test Gotify, we can create a test client and send a notification to it. There are two ways to create a client:
In this tutorial, we will use the CLI client. First, we need to install it:
# gotify-cli install
Next, we can use the CLI client to create a client and send a test notification:
$ gotify-cli init http://localhost:8080
$ gotify-cli create-app "Test Client"
$ gotify-cli send -t "Test Notification" -m "This is a test notification from Gotify."
If everything worked, you should receive a notification on your device.
Congratulations, you have successfully installed and configured Gotify on OpenBSD! Now you can start using it to receive notifications on your devices.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
