0.0.7 • Public • Published

    A real liveness-probe for Rocket.Chat

    We've seen cases where Rocket.Chat's node process is running, but users could not log in. At the same time, the node process was idling, so it was definitely not a performance issue. Also, requests to /api/v1/info were successful, even logging in via the API was working. Still, as a new session should be created, the client session timed out.

    In order to detect situations like these, this repo contains a liveness-check which validates whether users can actually operate the system (e. g. log in and out).


    Since this liveness-probe really wants to log in using a headless browser, you need to provide a user - default liveness, password 1iveness! Make sure this user has got no permissions (or very few, such as "guest").

    Headless on Amazon Linux

    From this awesome post instructs how to get chrome installed.

    Once we've done this, we can configure it to be used later-on.

    => curl | bash

    Of course, it's more secure to download / copy the script instead of just piping it to the bash ;)

    Installing this package

    Until it's not published to npm, for the sake of completeness:

    git clone
    cd rocketchat-liveness-check
    npm i

    How to run it

    ASSISTIFY_USER=liveness ASSISTIFY_PASSWORD=1iveness! SERVER=http://localhost:3000 CHROME=/usr/bin/google-chrome-stable npm run liveness

    You can omit the environment variables if you use the default values

    Server mode

    You can run the program also in server mode, which means, that the Chromium browser keeps running, while sending POST http://localhost:7000/loginTest with parameters server, user and password as payload.




    npm i rocketchat-liveness-check

    DownloadsWeekly Downloads






    Unpacked Size

    10.5 kB

    Total Files


    Last publish


    • jschirrmacher