obsidian/wiki/homelab/homarr-github-integration.md
2026-04-19 20:34:58 +01:00

1.8 KiB

title aliases tags sources created updated
Homarr Integration — GitHub
homarr-github
homarr-releases-widget
homarr
homelab
github
integrations
version-control
raw/Homarr documentation 7.md
2026-04-19 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 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
  • Pairs well with wiki/homelab/homarr-calendar-widget for a unified media + software release overview

Sources

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