A command line interface for pushing messages to gotify/server.
Alternatives To Cli
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
2 years ago17Dockerfile
Scan your container images for package vulnerabilities with Aqua Security
Canarytokens Docker531
3 months ago30bsd-3-clauseDockerfile
Docker configuration to quickly setup your own Canarytokens.
22 days ago7July 26, 202210mitGo
A command line interface for pushing messages to gotify/server.
Docker Github Runner204
2 years ago17mitDockerfile
Run GitHub Actions on self-hosted runner using Docker.
Cryptokylin Testnet140
4 years ago8Dockerfile Kylin Testnet by
7 years ago3cc0-1.0Python
Plex Media Server73
6 days ago2Dockerfile
Worlds smallest Docker image for Plex Media Server, built on spritsail/busybox
Action Release Debugapk57
a year ago2Dockerfile
🕷 Build and release debug APK from your Android project
Efb Wechat Docker54
17 days ago7Dockerfile
EFB WeChat Slave Docker Ver.
Jenkins Action52
2 years ago4mitDockerfile
GitHub Action that trigger Jenkins job.
Alternatives To Cli
Select To Compare

Alternative Project Comparisons

Gotify-CLI travus-badge badge-release

Gotify-CLI is a command line client for pushing messages to gotify/server. It is not required to push messages. See alternatives.


  • stores token/url in a config file
  • initialization wizard
  • piping support (echo message | gotify push)
  • simple to use
  • watch and push script result changes (gotify watch "curl | jq '.data'")


You can simply use curl, HTTPie or any other http-client to push messages.

$ curl -X POST "<apptoken>" -F "title=my title" -F "message=my message"
$ http -f POST "<apptoken>" title="my title" message="my message"



Download the latest release for your os: (this example uses version v2.2.0)

$ wget -O gotify
# or
$ curl -Lo gotify

Make gotify executable:

$ chmod +x gotify

Test if the Gotify-CLI works: (When it doesn't work, you may have downloaded the wrong file or your device/os isn't supported)

$ gotify version

It should output something like this:

Version:   2.2.0
Commit:    95cc125e39f805a1369b0c746c8bf3af15797a57
BuildDate: 2020-09-25-16:27:04

(optional) Move the executable to a folder on your $PATH:

$ mv gotify /usr/bin/gotify

Arch Linux

Gotify-CLI is available in the AUR, so you can install it with any AUR helper, i.e. yay:

$ yay -S gotify-cli

Maintenance of the AUR package is not performed by the Gotify team.


Gotify-CLI is available in Homebrew, so you can install it with:

$ brew install gotify

Maintenance of the Brew package is not performed by the Gotify team.


Now you can either run the initialization wizard or create a config manually. This tutorial uses the wizard.

$ gotify init

When you've finished initializing Gotify-CLI, you are ready to push messages to gotify/server.

Here are some examples commands, you can view the "push help" via gotify help push (or have a look at push help).

$ gotify push my message
$ gotify push "my message"
$ echo my message | gotify push
$ gotify push < somefile
$ gotify push -t "my title" -p 10 "my message"
$ gotify watch "curl | jq '.data'"


Uses version v2.2.0

   Gotify - The official Gotify-CLI

   gotify [global options] command [command options] [arguments...]


     init        Initializes the Gotify-CLI
     version, v  Shows the version
     config      Shows the config
     push, p     Pushes a message
     watch       watch the result of a command and pushes output difference
     help, h     Shows a list of commands or help for one command

   --help, -h     show help
   --version, -v  print the version

Watch help

   gotify watch - watch the result of a command and pushes output difference

   gotify watch [command options] <cmd>

   --interval value, -n value  watch interval (sec) (default: 2)
   --priority value, -p value  Set the priority (default: 0)
   --exec value, -x value      Pass command to exec (default: "sh -c")
   --title value, -t value     Set the title (empty for command)
   --token value               Override the app token [$GOTIFY_TOKEN]
   --url value                 Override the Gotify URL
   --output value, -o value    Output verbosity (short|default|long) (default: "default")

Push help

$ gotify help push
   gotify push - Pushes a message

   gotify push [command options] <message-text>

   the message can also provided in stdin f.ex:
   echo my text | gotify push

   --priority value, -p value    Set the priority (default: 0)
   --title value, -t value       Set the title (empty for app name)
   --token value                 Override the app token [$GOTIFY_TOKEN]
   --url value                   Override the Gotify URL
   --quiet, -q                   Do not output anything (on success)
   --contentType value           The content type of the message. See
   --disable-unescape-backslash  Disable evaluating \n and \t (if set, \n and \t will be seen as a string)


Note: The config can be created by gotify init.

Gotify-CLI will search the following paths for a config file:

  • /etc/gotify/cli.json
  • $XDG_CONFIG_HOME/gotify/cli.json
  • ~/.gotify/cli.json
  • ./cli.json


name description example
token an application token (a client token will not work) A4ZudDRdLT40L5X
url the URL to your gotify/server
defaultPriority Default priority ( set to 0 if not present) 6

Config example

  "token": "A4ZudDRdLT40L5X",
  "url": "",
  "defaultPriority": 6

Configuration option

If needed, you can disable SSL handcheck validation using an environment variable:



The Dockerfile contains the steps necessary to build a new version of the CLI and then run it in a minimal Alpine container.


docker build -t gotify/gotify-cli .

Run (this assumes your cli.json file is in the current working directory):

docker run -it -v "$PWD/cli.json:/home/app/cli.json" gotify/gotify-cli:latest push -p 5 "Test from Gotify CLI"
Popular Dockerfile Projects
Popular Token Projects
Popular Virtualization Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Push Notifications