---
title: "Homarr Integration — GitHub"
aliases: [homarr-github, homarr-releases-widget]
tags: [homarr, homelab, github, integrations, version-control]
sources: [raw/Homarr documentation 7.md]
created: 2026-04-19
updated: 2026-04-19
---

## GitHub Integration

GitHub is a version control and collaboration platform. Homarr connects to it to surface repository release information directly on your dashboard.

## Widgets & Capabilities

| Widget | Description |
|--------|-------------|
| **Releases** | Displays current version of specified repositories; supports a version regex filter |

- The Releases widget shows latest release tags across one or more GitHub repos
- Version regex lets you filter out pre-releases, RC builds, or match specific semver patterns

## Setup

1. Go to **Integrations Management** in Homarr admin
2. Add a new integration — select **GitHub**
3. Provide a GitHub personal access token (PAT) with `repo` read scope for private repos; public repos may not require auth
4. Save and link the integration to the Releases widget on your board

See [[wiki/homelab/homarr-integrations|Homarr Integrations — Third-Party App Connections]] for the general integration management flow.

## Key Takeaways

- GitHub integration exposes a single **Releases** widget — useful for monitoring self-hosted software versions at a glance
- Version regex filtering allows precise control over which release tags are displayed (e.g. exclude pre-releases)
- Setup follows the standard Homarr integration flow via [[wiki/homelab/homarr-integrations|Integrations Management]]
- Pairs well with [[wiki/homelab/homarr-calendar-widget|Calendar Widget]] for a unified media + software release overview

## Sources

- `raw/Homarr documentation 7.md` — Homarr official docs, GitHub integration page (v1.59.2)
