Installation

In the instructions below, your copy of zulipbot 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 (version >= v7.4.0) and npm (version >= 4.3.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.

  If joinEnabled is enabled in src/config.js, you will also need to invite @zulipbot's user account to your organization and change its permission level to Owner.

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.
• Set the Content type field to application/json.
• 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. Any npm WARN warnings can be safely ignored.

$ npm install

Configuration

1. Create two files in the src folder: one file named config.js, the other named secrets.js.

$ touch src/config.js
$ touch src/secrets.js

2. Open src/config.js in your preferred text editor.

3. Edit the contents of src/config.js, using src/zulip_project.config.js as a guide; visit the Configuration page for more details.

4. Once you are finished modifying src/config.js, run tools/configLint to check if your configuration file was set up properly.

$ tools/configLint

5. Open src/secrets.js in your preferred text editor.

6. Edit the contents of src/secrets.js as follows:

module.exports = {
  username: "Username123", // Username123 is the username of @zulipbot's GitHub user account
  password: "Password456" // Password456 is the password of @zulipbot's GitHub user account
};

7. Run the bot to ensure that your environment was configured correctly.

$ npm start

---

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