/matrix-appservice-slack

A Matrix <--> Slack bridge

Primary LanguageTypeScriptApache License 2.0Apache-2.0

matrix-appservice-slack

Docker Automated build #slack:half-shot.uk Build status Documentation Status

A bridge that connects Matrix and Slack. The bridge is considered stable and mature for use in production environments.

Screenshot

Requirements

Hosting this bridge requires you to have a Matrix homeserver. In order to connect a Slack Workspace to your bridge, you will need permission to add bots to it. You will also need Node.JS 12+ or Docker on your system.

NOTE: Slack has introduced a new type of 'Slack App', which is not compatible with this bridge. Instead, you will need to create a "Classic Slack App" for this bridge. Existing installations will not need to modify their setups, as all pre-existing Slack apps became Classic Slack apps. We are looking to make the bridge compatible with both types, but in the meantime please only use Classic Slack Apps.

Setting up

See the getting started docs for instructions on how to set up the bridge.

Helping out

This bridge is a community project and welcomes issues and PRs from anyone who has the time to spare. If you want to work on the bridge, please see CONTRIBUTING.md. Please come visit us in the support room if you have any questions.