Self Hosted Push Notifications with Gotify

Tags: #<Tag:0x00007f3270677bf0>

Hi All,

I’ve been looking for a self hosted push notification platform for what seems like forever. Now I think I’ve finally found it: Gotify. The good news is it can be integrated easily with HASS via the REST notification platform.

I’ve written up all the details on my blog (it’s a bit long!):

Please let me know what you think!


I came across this on your website while reading about the sound system.
This platform is fantastic. Installed it as per your guide and notifications are really instantaneous.
Do share if you work out how to make actionable notifications.

Thank you very, very much for sharing this.

Thanks for the kind feedback!

Yeah, the notifications are really quick, I also get simultaneous notifications on desktop and mobile. I’ve not had chance to get back to looking into actionable notifications yet, but I’ll be sure to write it up when I do.

have you found a way to set priority when sending messages from hass? I tried adding priority in the data extras, but it doesn’t work as i imagined

    "title": "Hello World!",
    "message": "Hello from Home Assistant via Gotify",
    "data": { "priority": 8 }

I just tried your code and I receive the notifications, but they don’t look any different from the normal ones. To be honest I’m not exactly sure what the priority is supposed to do!

I’m not getting notifications on the android app. Messages are delivered, but according to the docs ( one must specify priority above 0 for system phone notifications (eg “Icon in notification bar”).

@robconnolly are you getting actual phone notifications without specifying priority?

Yes, I get system notifications. Have you checked the notification settings for the gotify app? It’s possible your notifications are being silenced by the system.

I don’t actually see anything related to notifications in the app itself… I ended up hardcoding the priority and create a few different services for various priority levels.

  - name: gotify_priority_10
    platform: rest
    resource: http://.../message
    method: POST_JSON
      X-Gotify-Key: !secret gotify_key
    message_param_name: message
    title_param_name: title
      priority: 10

I’m thinking there has to be a way to get it to work correctly with data_template, but I wasn’t able to get it to work in reasonable amount of time.

1 Like

The notification settings for each app are in the device settings, under Apps->Gotify->Notifications for me. Looks like there are some settings in there for different priority levels, but all mine are just set to “Sound”.

Interesting, I found what you are talking about. There are settings for various priority messages and how to react to them.

For clarification, this is in the phone’s system settings, not in the app iteself.

@robconnolly thank you so much for your help!

Yep, exactly. Let me know if these correspond to the priority levels from Gotify. I haven’t had a chance to play around with it yet, but I can imagine it would be useful.

Hi there,

I got stuck exactly at the same point.
Thanks for your hard coded workaround solution ! (a lot better than nothing)
I believe there is a way to define the priority as an added notification parameter using the data: syntax
in the documentation it is mentioned:

Dictionary of extra parameters to send to the resource.

…but I failed to “guess” the correct way to do it.
did you ever solved it?

Ended up using multiple notify targets.

I’m curious as well if there has been support added to specify priority in each request. I’ve added message_param_name and title_param_name; those work. I assumed priority_param_name would work as well but it does not.


  • name: Gotify
    platform: rest
    method: POST
    resource: “https://server
    message_param_name: message
    title_param_name: title
1 Like

thx Rob for this great tutorial!

Did anyone manage to get the priority working without the workaround?

Notify setup

- name: gotify
  platform: rest
  resource: http://tasks.gotify_app/message
  method: POST
    X-Gotify-Key: !secret gotify_hass
  message_param_name: message
  title_param_name: title
  target_param_name: priority


title: title
message: message
target: 8

Target is your priority. Enjoy

Note: that your method must be POST and not POST_JSON. As POST_JSON will tell Gotify that your priority value is a string and you will get an error. Setting it to POST lets Gotify decode a Form Post submission and interpret as a number.

Thanks, can confirm that works to set priority!
Surprised Gotify isn’t more popular, seems to work well.