In this guide we will show you how you can enable the Slack integration on your on self-hosted Lightdash server.
First we will have to create a Slack APP https://api.slack.com/apps?new_app=1
You can select From an app manifest
to make it easier.
Then select the workspace you want to enable this into. Later you can enable distribution
if you want to use a different Slack workspace.
Then copy this manifest to allow URL unfurls in your app. Make sure you update your-lightdash-deployment-url.com
in the manifest below (for example, app.lightdash.cloud
).
Finally, click on create
Now copy the following credentials from your new app.
From Basic Information
Now you need to add the following environment variables to your Lightdash server using the credentials we previously copied
SLACK_CLIENT_ID
: Client ID (make sure it is between quotes, so it is a string, not a number)SLACK_CLIENT_SECRET
: Client secretSLACK_SIGNING_SECRET
: Signing secretSLACK_STATE_SECRET
: This can be any stringRestart your Lightdash service, now you should be able to use the Slack integration on your self-hosted Lightdash.