Check rocketchat-version


This plugin lets you track if a Rocket.Chat server update is available. To check for updates, this plugin uses the Git Repo at To compare against the current/installed version of Rocket.Chat, the check needs URL/API access to the Rocket.Chat server.

Fact Sheet

Check Plugin Download

Check Interval Recommendation

Once a day

Can be called without parameters


Compiled for

Linux, Windows


Requires a user with strong password and ‚view-statistics‘ permission (only).

Uses SQLite DBs



usage: rocketchat-version [-h] [-V] [--always-ok]
                          [--cache-expire CACHE_EXPIRE] [--insecure]
                          [--no-proxy] -p PASSWORD [--timeout TIMEOUT]
                          [--url URL] --username USERNAME

This plugin lets you track if server updates are available. Requires a user
with strong password and "view-statistics" permission (only).

  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  --always-ok           Always returns OK.
  --cache-expire CACHE_EXPIRE
                        The amount of time after which the update check cache
                        expires, in hours. Default: 24
  --insecure            This option explicitly allows to perform "insecure"
                        SSL connections. Default: False
  --no-proxy            Do not use a proxy. Default: False
  -p PASSWORD, --password PASSWORD
                        Rocket.Chat API password.
  --timeout TIMEOUT     Network timeout in seconds. Default: 3 (seconds)
  --url URL             Rocket.Chat API URL. Default:
  --username USERNAME   Rocket.Chat API username. Default: rocket-stats

Usage Examples

./rocketchat-version --username rocket-stats --password mypassword --url http://rocket:3000/api/v1 --cache-expire 8 --always-ok


Rocket.Chat v6.6.2 installed, Rocket.Chat v6.6.3 available


  • If wanted, always returns OK,

  • else returns WARN if update is available.

Perfdata / Metrics

There is no perfdata.

Credits, License