Installation

In the instructions below, your production installation of the zulipbot software will be referred to as @zulipbot.

Prerequisites

Before you get started, make sure you have:

• installed and configured Git on your local machine
• installed Node.js (v7.6.0 <= version < 9.0.0) and yarn (version >= 1.0.0)
• created a GitHub user account for @zulipbot to use
• invited @zulipbot's user account to collaborate on your repository, changing its permission level in the repository to Admin.

Server

In order to receive events from GitHub, @zulipbot must be running on a server. We recommend using Heroku or Amazon Web Services (AWS) for hosting your copy of @zulipbot, since both services offer free plans to their consumers. You can choose to host your copy of @zulipbot locally, but it is highly discouraged.

Once you have secured a server for @zulipbot to operate on, add a repository webhook to @zulipbot's server:

• Enter your server's URL in the Payload URL field, appended by /github (e.g. https://your-server.com/zulipbot/github).
• Set the Content type field to application/json.
• Set the Secret field to a secure token that will be used to validate webhook payloads from GitHub. Read the GitHub webhook documentation for more information.
• Select the "Send me everything." option in the Which events would you like to trigger this webhook? field.

Installation

1. Open your command line interface (CLI).

2. Download the latest release or clone this repository to your local machine.

$ git clone https://github.com/zulip/zulipbot.git

3. Switch to the local copy of this repository.

$ cd ~/path-to-repo/zulipbot

4. Install the necessary node packages and dependencies.

$ yarn install

Configuration

Visit the Configuration page for more details.

---

Congratulations, you have finished the installation of @zulipbot! You can now begin using @zulipbot to manage your repository.