morgenruf.dev

Getting Started

Add Morgenruf to your Slack workspace and run your first standup in minutes.

Hosted Version (Easiest)

The fastest way to get started is with the hosted version — nothing to install, nothing to configure beyond a few DM commands.

  1. Add Morgenruf to Slack

    Click the button below to start the Slack OAuth flow. You'll be asked to authorize Morgenruf to send messages and read channel info.

    Add to Slack

  2. Authorize the app

    Slack will show you an OAuth permission screen listing what Morgenruf needs. Review the scopes and click Allow. You'll be redirected back to Slack.

  3. Welcome DM arrives

    Within a few seconds, Morgenruf sends you a welcome DM and a welcome email (if RESEND_API_KEY is configured). Your next step is to configure the bot via the dashboard.

  4. Visit the dashboard to configure

    Go to https://<your-api-domain>/dashboard to set your standup channel, schedule, timezone, questions, and which team members participate.

  5. Invite the bot to your standup channel

    In the channel where you want summaries posted, run:

    /invite @Morgenruf
    slack
ℹ️

Only the person who installs Morgenruf needs to go through the OAuth flow. Other team members are added via the dashboard's Members section.

What Happens Next

After installation and dashboard configuration, Morgenruf runs on autopilot:

  • At the configured time, each participant receives a standup DM with your questions
  • If a reminder is configured, a heads-up DM goes out N minutes before standup time
  • Once responses are collected, a summary is posted to your standup channel
  • Participation analytics are tracked in the dashboard's Analytics tab

See the Configuration page for everything you can configure in the dashboard.

Invite Morgenruf to Your Channel

To let Morgenruf post standup summaries in a channel, invite it there:

/invite @Morgenruf
slack

Run this inside the channel you selected in the dashboard as your standup channel. The bot needs to be a member of the channel to post the daily summary.

Your First Standup

Standups run automatically at the configured time. To trigger one immediately for testing, DM the bot:

standup
slack dm

Morgenruf will walk you through four questions, one at a time:

M
Morgenruf 9:00 AM
🌅 Time for your standup!

What did you work on yesterday?
Y
You9:01 AM
Finished the auth refactor and reviewed two PRs.
M
Morgenruf9:01 AM
Got it! What are you working on today?
Y
You9:02 AM
Writing tests for the new API endpoints.
M
Morgenruf9:02 AM
Any blockers or anything the team should know?
Y
You9:02 AM
Nope, all good.
M
Morgenruf9:02 AM
Last one — how are you feeling today? 😊 😐 😔
Y
You9:03 AM
😊
M
Morgenruf9:03 AM
✅ All done! Your standup has been recorded and will appear in #standup.
💡

The mood question (😊/😐/😔) is tracked in the Analytics tab. The edit window (configurable in the dashboard) lets users update their answers after submitting.

Prefer to Self-Host?

If you'd rather run Morgenruf on your own infrastructure, check out the dedicated guides:

🐳

Docker Compose

Spin up Morgenruf + PostgreSQL with a single docker compose up.

 ☸️

Kubernetes / Helm

Deploy to any Kubernetes cluster using the official Helm chart.