Running your own slackin on Azure

slackin is an amazing tool written by Guillermo Rauch to help build public Slack () communities. As a result, it's being used by projects including GitHub's Atom, Socket.IO, and in my very own personal project -- VSCodeVim (an extension to Visual Studio Code to enable VIM bindings). In this post, I'll explain how to get an instance of slackin running on Azure in a matter of minutes. Best of all, it's FREEEEE !

Pieces of the Puzzle

After a tiny change to make slackin work across platforms ( + + ), slackin can be deployed within an Azure Web App. The Azure Resource Manager template does the magic of telling Azure what it needs to deploy and how. In this case, it'll deploy an instance of an Azure Web App (on the free tier) and run a Kudu start-up script to install and configure slackin.

I'm ready, let's start slackin on Azure

  1. Make your way to the slackin repository and hit the 'Deploy to Azure' button on the Readme. It looks something like this: Deploy to Azure Button

  2. The button will redirect you to the Azure Portal where you'll need to login. If you don't already have an account, you can sign up for free here.

  3. The deployment wizard will walk through the configurations that are needed in order to deploy slackin but here's a breakdown:

    • Site Name: The name of your site which will be accessible at [site-name].azurewebsites.net`.
    • Site Location: The location of your web app. You can find all available locations here.
    • Slack Team ID: The name of your slack team (e.g. https://[this].slack.com).
    • Slack Api Token: The API token available at https://api.slack.com/web.
    • Slackin Release: Choice between stable or release.
      • stable: Deploys the latest released version of slackin from npm.
      • release: Bleeding edge baby. Deploys master branch of the slackin git repo.
  4. Click the Next/Create button, fast-forward a couple of minutes and.... slackin on Azure!

The whole experience looks like this:

Happy slackin!