Copy the Client ID and Client Secret in the resulting screen.Click Generate a new client secret and provide your GitHub password to continue.This value needs to match the Mattermost server URL that you or your users users log in to. Authorization callback URL:, replacing with your Mattermost URL.Application name: Mattermost GitHub Plugin.You must first register the Mattermost GitHub Plugin as an authorized OAuth app regardless of whether you're setting up the GitHub plugin as a system admin or a Mattermost user. Step 1: Register an OAuth Application in GitHub Note: If you're using GitHub Enterprise, replace all GitHub links below with your GitHub Enterprise URL. GitHub plugin configuration starts by registering an OAuth app in GitHub and ends in Mattermost. You're running Mattermost v5.12 or higher.Slash commands - Interact with the GitHub plugin using the /github slash command.Sidebar buttons - Stay up-to-date with how many reviews, unread messages, assignments, and open pull requests you have with buttons in the Mattermost sidebar.Hover over a post to reveal the post actions menu and click More Actions (.). Post actions - Create a GitHub issue from a post or attach a post message to an issue.Notifications - Get a direct message in Mattermost when someone mentions you, requests your review, comments on or modifies one of your pull requests/issues, or assigns you on GitHub.Daily reminders - The first time you log in to Mattermost each day, get a post letting you know what issues and pull requests need your attention.Once connected, you'll have access to the following features: The Events don’t need separate configuration.Īfter a System Admin has configured the GitHub plugin, run /github connect in a Mattermost channel to connect your Mattermost and GitHub accounts. Events notifications are via DM in Mattermost. The Mattermost GitHub plugin uses a webhook to connect your GitHub account to Mattermost to listen for incoming GitHub events. This repository is licensed under the Apache 2.0 License. For more information about contributing to this plugin, visit the Development section. This guide is intended for Mattermost System Admins setting up the GitHub plugin, Mattermost users who want information about the plugin functionality, and Mattermost users who want to connect their GitHub account to Mattermost. Supports GitHub SaaS and Enterprise versions. Maintainer: Co-Maintainer: GitHub plugin for Mattermost.

Mattermost webhook