Running Butler Auth as a native Node.js application
While Qlik Sense Enterprise is a Windows only system, Butler Auth runs on any OS where Node.js is available.
Butler Auth has been succesfully used using standard Node.js - during development and production - on Windows, Linux (Debian and Ubuntu tested) and Mac OS.
Running as Node.js app
|Sense Enterprise||Mandatory. Butler Auth is developed with Qlik Sense Enterprise on Windows in mind.|
|InfluxDB||Optional. A database for realtime information, used to store metrics around Butler Auth’s own memory usage over time (if this feature is enabled).|
Butler Auth was developed and tested using the 64 bit version of Node.js. The most recent LTS (Long Term Support) version of Node.js is a good choice for running Butler. At time of this writing, Node.js 14.5 is used.
Decide where to install Butler Auth
It is usually a good starting point to run Butler Auth on a Sense server.
On the other hand, you might want to keep the Sense servers as clean as possible (with respect to software running on them). If that is a priority you should install Butler Auth on some other server. A small “utility” or “misc” server can often be useful for running various add-on services to Qlik Sense.
The bottom line is that Butler Auth can run on any server, as long as Node.js is available and there is network connectivity to the actual Qlik Sense server(s).
Download Butler Auth
Download the repository zip from the releases page file or clone the Butler Auth repository using your git tool of choice. Both options achieve the same thing, i.e. a directory such as d:\node\butler-auth, which is then Butler Auth’s root directory.
Install node dependencies
From a Windows command prompt (assuming the Butler ZIP file/repository was extracted to d:\node\butler-auth):
d: cd \node\butler-auth\src npm install
This will download and install the Node.js modules used by Butler Auth.
Configuration of Butler Auth is done more or less the same way as configuring for Docker, i.e. get certificates from Qlik Sense Enterprise on Windows > store them in suitable location > refer to those cert files from
More details are then available in the on the Configuration pages.
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.