Skip to content

Installing Slab

Tyler Conlee edited this page Mar 7, 2019 · 1 revision

Rough outline of how to install Slab, to be expanded upon:

  • Configure Slack App
  • Slack App must have a valid SSL enabled URL to use for callbacks
  • Get the OAuth key for the app
  • Configure Server
  • Should have a web server (nginx works great) configured with a SSL cert
  • Should be running on an unused port
  • Supervisor should be installed to ensure Slab is always running

Sample Supervisord config for Slab:

[program: slab]
command =/home/ubuntu/slab -key=<Slack-OAuth-Key> -port=8080 -time=1m -db=0 -log=debug
autostart = true
startsecs = 5
user = ubuntu
redirect_stderr = true
stdout_logfile = slab.log

Within that command, there are several configurable options.

  • The most important is the Slack OAuth key. Without it, nothing works.
  • Port is the port that Slab will be running on - should be the same port configured in your web server with SSL
  • Time is the time in between loops that Slab makes to poll Zendesk for new ticket information.
  • db is the Redis database number to use
  • log is the log level

Once running, Slab has a configuration wizard within Slack. To run it, invite the @slab bot user to a channel and run @slab config start and follow the steps that are direct messaged to you.

After that process is complete, [configure tags] to alert on, and Slab will take care of the rest!

Clone this wiki locally