Skip to content
Snippets Groups Projects
Commit d8f25a7c authored by Allen Gilliland's avatar Allen Gilliland
Browse files

updates to admin guide to account for changes on email setup and add new doc for slack setup.

parent 2163d4f1
No related branches found
No related tags found
No related merge requests found
......@@ -5,7 +5,7 @@ Once you connect your database to Metabase, you'll want to configure an email ac
### Configuring your Email Account
For Metabase to send and receive messages to your organization's users, you'll need to set up an email account to send emails via *SMTP* (simple mail transfer protocol), which is an email standard that secures emails with SSL security protection.
For Metabase to send messages to your organization's users, you'll need to set up an email account to send emails via *SMTP* (simple mail transfer protocol), which is an email standard that secures emails with SSL security protection.
To start, go to the Admin Panel from the dropdown menu in the top right of Metabase, then from the Settings page, click on **Email** in the left menu.
......@@ -22,9 +22,9 @@ You should see this form:
* Enter the email address you would like to be used as the sender of system notifications in the **From Address* field.
**If you use Amazon SES:**
* Log on to [https://console.aws.amazon.com/ses](https://console.aws.amazon.com/ses).
* Log on to [https://console.aws.amazon.com/ses](https://console.aws.amazon.com/ses).
* Click **SMTP Settings** from the navigation pane.
* Select **Create My SMTP Credentials** in the content pane.
* Select **Create My SMTP Credentials** in the content pane.
* Create a user in the **Create User for SMTP** dialog box and then click **Create**.
* Next, select **Show User SMTP Credentials** to view the user's SMTP credentials.
* Go back to the Metabase Admin Panel form and enter the info there.
......
......@@ -15,3 +15,8 @@ The **report timezone** sets the default time zone for displaying times. The tim
### Anonymous Tracking
This option turns determines whether or not you allow anonymous data about your usage of Metabase to be sent back to us to help us improve the product. *Your database’s data is never tracked or sent*.
---
## Next: Setting up Slack
If you want to use Slack to enhance the Metabase experience then lets do that now. Let’s learn [how to setup Slack](07-setting-up-slack.md).
## Setting up Slack
If you are using Slack for team communication and would like to have your Pulses be sent to Slack channels (or users) then you'll need to integrate your Metabase instance with Slack. Luckily, this is really easy!
### Generating a Slack API Token
For Metabase to post to your Slack channels, you'll need to generate a Slack API token and make it available to Metabase.
To start, go to the Admin Panel from the dropdown menu in the top right of Metabase, then from the Settings page, click on **Slack** in the left menu.
You should see this form:
![Slack Settings](images/SlackSettings.png)
Then just click on the large and conveniently placed button `Get an API token from Slack` which will open a new browser tab and send you over to Slack to create the token.
Click over to the tab that was opened and you'll now be on the Slack API page under the Authentication section which will show you any API tokens that you have created for your various Slack teams.
![Slack API Auth](images/SlackAPIAuth.png)
Now just click the `Create token` button next to the team you want to integrate with and a token will be generated for you. It will look like `xoxp-etc-etc-etc` and all you need to do is copy that value and head back to Metabase.
Paste the value into the text box for `Slack API Token` and click the button to save your changes. That's it! Metabase will automatically run a quick test to check that the API token is working properly and if not you'll get an error message.
docs/administration-guide/images/EmailCredentials.png

122 KiB | W: | H:

docs/administration-guide/images/EmailCredentials.png

124 KiB | W: | H:

docs/administration-guide/images/EmailCredentials.png
docs/administration-guide/images/EmailCredentials.png
docs/administration-guide/images/EmailCredentials.png
docs/administration-guide/images/EmailCredentials.png
  • 2-up
  • Swipe
  • Onion skin
docs/administration-guide/images/SlackAPIAuth.png

334 KiB

docs/administration-guide/images/SlackSettings.png

117 KiB

0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment