Getting started¶
Pick the path that fits your situation.
Step 1: Deploy Osmia¶
-
Try it locally first
No Kubernetes cluster needed. Get Osmia running with Docker Compose in 5 minutes.
Best for first-time users, quick evaluation and learning how Osmia works.
-
Deploy to Kubernetes
Deploy Osmia with Helm on any Kubernetes cluster.
Best for Kubernetes engineers, production deployments and team evaluations.
Step 2: Connect your tools¶
Once Osmia is running, follow the guide for your ticketing and notification setup:
-
GitHub Issues + Slack
Picks up GitHub issues labelled
osmia, posts results to Slack and opens pull requests. -
Shortcut + Slack
Picks up Shortcut stories assigned to
@osmia, moves them through workflow states and posts results to Slack. -
Linear + Slack
Picks up Linear issues labelled
osmia, tracks them with labels and posts results to Slack.
After setup¶
- Configuration Reference: every config option
- Troubleshooting: common issues and how to fix them
- What is Osmia?: the concepts behind the tool
- Guard Rails Overview: the safety layers