---
title: Charmhub | Deploy GitHub Runner Webhook Router using Charmhub - The Open Operator
  Collection
description: Deploy the latest version of GitHub Runner Webhook Router as a Kubernetes
  Operator on any cloud. A webserver which forwards webhooks from Github to a mq.
url: https://charmhub.io/github-runner-webhook-router
---

# GitHub Runner Webhook Router

[Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

* [Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

Platform:

stable 77

```
juju deploy github-runner-webhook-router
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

#### Relevant links

* [Contact](https://launchpad.net/~canonical-is-devops)

---

#### Contacts

##### Maintainers

+ [Launchpad Team](https://launchpad.net/~canonical-is-devops)

* [Submit a bug](https://github.com/canonical/github-runner-webhook-router/issues)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

# GitHub runner webhook router operator

A Juju charm deploying and managing a simple Flask application that listens for incoming webhooks
from GitHub and places a translation of those in a message queue for a runner to pick up and process.
It is intended to be used together with the [Github runner operator](https://charmhub.io/github-runner)
in reactive mode.

This charm simplifies initial deployment and “day N” operations of
the application on Kubernetes. It allows for deployment on many
different Kubernetes platforms, from [MicroK8s](https://microk8s.io)
to [Charmed Kubernetes](https://ubuntu.com/kubernetes) to public cloud
Kubernetes offerings.

For DevOps or SRE teams this charm will make operating the Flask application simple
and straightforward through Juju’s clean interface. It will allow easy
deployment into multiple environments for testing of changes.

The charm integrates with the [Canonical Observability Stack](https://charmhub.io/topics/canonical-observability-stack)
to provide application and Flask related metrics via Grafana dashboards.

## [In this documentation](https://charmhub.io/github-runner-webhook-router#p-37500-in-this-documentation)

|  |  |
| --- | --- |
| – | Explanation   Concepts - discussion and clarification of key topics |

## [Contributing to this documentation](https://charmhub.io/github-runner-webhook-router#p-37500-contributing-to-this-documentation)

Documentation is an important part of this project, and we take the
same open-source approach to the documentation as the code. As such,
we welcome community contributions, suggestions and constructive
feedback on our documentation. Our documentation is hosted on the
[Charmhub forum](https://discourse.charmhub.io/) to enable easy
collaboration. Please use the “Help us improve this documentation”
links on each documentation page to either directly change something
you see that’s wrong, or ask a question, or make a suggestion about a
potential change via the comments section.

If there’s a particular area of documentation that you’d like to see that’s
missing, please [file a bug](https://github.com/canonical/github-runner-webhook-router/issues).

## [Project and community](https://charmhub.io/github-runner-webhook-router#p-37500-project-and-community)

The Github Runner Webhook Router Operator is a member of the Ubuntu family. It’s an open-source project that warmly welcomes community
projects, contributions, suggestions, fixes, and constructive feedback.

* [Code of conduct](https://ubuntu.com/community/code-of-conduct)
* [Get support](https://discourse.charmhub.io/)
* [Join our online chat](https://matrix.to/#/#charmhub-charmdev:ubuntu.com)
* [Contribute](https://github.com/canonical/github-runner-webhook-router/blob/main/CONTRIBUTING.md)

Thinking about using the Github Runner Webhook Router Operator for your next project?
[Get in touch](https://matrix.to/#/#charmhub-charmdev:ubuntu.com)!

---

[Help improve this document in the forum](https://discourse.charmhub.io/t/github-runner-webhook-router-documentation-overview/17726) ([guidelines](https://discourse.charmhub.io/t/how-to-write-docs-our-documentation-guidelines-for-contributors/1245)). Last updated 1 year, 1 month ago.