Add Gatus Integration by TN-1 · Pull Request #175085 · home-assistant/core

TN-1 · 2026-06-29T02:44:00Z

Proposed change

This PR is adding an integration to support Gatus Uptime Monitoring. Initial support is limited to binary sensors representing the monitored endpoints. https://github.com/TwiN/gatus

Type of change

Dependency upgrade
Bugfix (non-breaking change which fixes an issue)
New integration (thank you!)
New feature (which adds functionality to an existing integration)
Deprecation (breaking change to happen in the future)
Breaking change (fix/feature causing existing functionality to break)
Code quality improvements to existing code or addition of tests

Additional information

This PR fixes or closes issue: fixes #
This PR is related to issue:
Link to documentation pull request: Add documention for new integration Gatus home-assistant.io#46533
Link to developer documentation pull request:
Link to frontend pull request: Move Gatus branding from custom to core integration brands#10642

Checklist

I understand the code I am submitting and can explain how it works.
The code change is tested and works locally.
Local tests pass. Your PR cannot be merged unless tests pass
There is no commented out code in this PR.
I have followed the development checklist
I have followed the perfect PR recommendations
The code has been formatted using Ruff (ruff format homeassistant tests)
Tests have been added to verify that the new code works.
Any generated code has been carefully reviewed for correctness and compliance with project standards.

If user exposed functionality or configuration variables are added/changed:

Documentation added/updated for www.home-assistant.io

If the code communicates with devices, web services, or third-party tools:

The manifest file has all fields filled out correctly.
Updated and included derived files by running: python3 -m script.hassfest.
New or updated dependencies have been added to requirements_all.txt.
Updated by running python3 -m script.gen_requirements_all.
For the updated dependencies a diff between library versions and ideally a link to the changelog/release notes is added to the PR description.

To help with the load of incoming pull requests:

I have reviewed two other open pull requests in this repository.

home-assistant

Hi @TN-1

It seems you haven't yet signed a CLA. Please do so here.

Once you do that we will be able to review and accept this pull request.

Thanks!

home-assistant · 2026-06-29T02:44:07Z

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

Copilot

Pull request overview

This PR adds a new "Gatus" integration for Home Assistant that polls a Gatus uptime-monitoring instance and exposes its monitored endpoints as connectivity binary sensors. It introduces the standard integration scaffolding (manifest, config flow, coordinator, binary sensor platform, strings, quality scale, CODEOWNERS, and generated registries) plus config-flow tests, matching how new service integrations are typically registered in the codebase.

Changes:

New gatus integration: config flow (URL entry + validation), 30s polling coordinator, and connectivity binary sensors per endpoint.
Config-flow test suite plus bronze quality-scale declaration.
Generated registry updates (integrations.json, config_flows.py) and CODEOWNERS entry.

Reviewed changes

Copilot reviewed 12 out of 14 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
homeassistant/components/gatus/init.py	Setup/unload of the config entry and runtime coordinator
homeassistant/components/gatus/config_flow.py	User config flow validating the Gatus URL
homeassistant/components/gatus/coordinator.py	Polls Gatus statuses API every 30s
homeassistant/components/gatus/binary_sensor.py	Connectivity sensors; unique IDs not entry-scoped
homeassistant/components/gatus/manifest.json	Manifest carries several unused empty keys
homeassistant/components/gatus/quality_scale.yaml	Marks non-applicable rules `done` instead of `exempt`
homeassistant/components/gatus/const.py / strings.json	Domain constant and UI strings
tests/components/gatus/*	Config-flow tests; no platform/coordinator tests
homeassistant/generated/* , CODEOWNERS	Registry and ownership entries

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 12 out of 14 changed files in this pull request and generated 4 comments.

Stale

Copilot

Pull request overview

Copilot reviewed 12 out of 14 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated 5 comments.

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated 2 comments.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated 2 comments.

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated 3 comments.

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated no new comments.

TN-1 · 2026-07-10T23:53:43Z

Thanks again for the review @joostlek.

Test failures again appear to not be related to my code, is the CI really buggy at the moment or is it just me?

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 20 out of 22 changed files in this pull request and generated 1 comment.

+        """Return the most recent monitoring result (Gatus appends newest last)."""
+        results = self.endpoint_data.results
+        if not results:
+            return None
+        return results[-1]


github-actions · 2026-07-14T15:27:12Z

Check requirements

Checked at commit 83cb680.

⚠️ Some checks require attention — see the details below.

Package	Old	New	No Advisories	Not Yanked	Repo Public	CI Upload	Release Pipeline	Security	PR Link	Async Safe
gatus-api	—	1.0.3	✅	✅	❌	✅	✅	❌	❌	❌

📦 gatus-api: 1.0.3

No Advisories: ✅ No active advisories reported by PyPI for version 1.0.3.
Not Yanked: ✅ Version 1.0.3 is a live (non-yanked) release.
Repo Public: ❌ PyPI does not advertise a source repository URL.
CI Upload: ✅ Trusted Publisher attestation found (GitHub).
Release Pipeline: ✅ OIDC via Trusted Publisher attestation (GitHub); automated CI upload verified by PyPI.
Security: ❌ No source repository URL on PyPI — source cannot be inspected.
PR Link: ❌ PyPI does not advertise a source repository URL.
Async Safe: ❌ PyPI does not advertise a source repository URL.

Generated by Check requirements (AW) · 31.9 AIC · ⌖ 16.7 AIC · ⊞ 31.4K · ◷

joostlek · 2026-07-14T15:46:38Z

Please send me a message on Discord

Add Gatus Integration

f5e8e64

Copilot AI review requested due to automatic review settings June 29, 2026 02:44

home-assistant Bot previously requested changes Jun 29, 2026

View reviewed changes

home-assistant Bot added cla-needed has-tests new-integration integration: gatus quality-scale labels Jun 29, 2026

home-assistant Bot marked this pull request as draft June 29, 2026 02:44

TN-1 mentioned this pull request Jun 29, 2026

Add documention for new integration Gatus home-assistant/home-assistant.io#46533

Merged

8 tasks

Copilot started reviewing on behalf of TN-1 June 29, 2026 02:44 View session

home-assistant Bot added cla-recheck cla-signed and removed cla-recheck cla-needed labels Jun 29, 2026

Copilot AI reviewed Jun 29, 2026

View reviewed changes

Add key to allow multiple instances

ce3f019

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings June 29, 2026 02:51

Copilot started reviewing on behalf of TN-1 June 29, 2026 02:52 View session

Copilot AI reviewed Jun 29, 2026

View reviewed changes

Comment thread homeassistant/components/gatus/binary_sensor.py Outdated

Comment thread homeassistant/components/gatus/quality_scale.yaml Outdated

Comment thread homeassistant/components/gatus/quality_scale.yaml Outdated

Comment thread homeassistant/components/gatus/coordinator.py Outdated

TN-1 mentioned this pull request Jun 29, 2026

Move Gatus branding from custom to core integration home-assistant/brands#10642

Merged

10 tasks

TN-1 added 2 commits June 29, 2026 12:32

Implement feedback from Copilot review

d99a355

Merge branch 'gatus' of github.com:TN-1/core into gatus

58a097f

TN-1 marked this pull request as ready for review June 29, 2026 03:12

Copilot AI review requested due to automatic review settings June 29, 2026 03:12

Copilot started reviewing on behalf of TN-1 June 29, 2026 03:13 View session

Copilot AI reviewed Jun 29, 2026

View reviewed changes

Comment thread homeassistant/components/gatus/quality_scale.yaml Outdated

Fix quality scale per review

9892487

Copilot AI reviewed Jul 9, 2026

View reviewed changes

Implement copilot feedback

b72338a

Copilot AI reviewed Jul 9, 2026

View reviewed changes

Comment thread homeassistant/components/gatus/manifest.json

Comment thread tests/components/gatus/test_binary_sensor.py Outdated

Apply suggestions from code review

576fd5b

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI reviewed Jul 9, 2026

View reviewed changes

Comment thread tests/components/gatus/test_binary_sensor.py

TN-1 added 2 commits July 9, 2026 15:54

Implement copilot feedback

8fb8c3b

Implement copilot feedback

9375576

Copilot AI reviewed Jul 9, 2026

View reviewed changes

Comment thread homeassistant/components/gatus/config_flow.py Outdated

Implement copilot feedback

4336968

Copilot AI reviewed Jul 9, 2026

View reviewed changes

Comment thread tests/components/gatus/test_binary_sensor.py

Fix test coverage

9e31db5

Copilot AI reviewed Jul 9, 2026

View reviewed changes

Comment thread tests/components/gatus/test_binary_sensor.py

Comment thread homeassistant/components/gatus/coordinator.py Outdated

Move JSON parsing to gatus-api library and use typed models

7ae9d27

Copilot AI reviewed Jul 10, 2026

View reviewed changes

Comment thread homeassistant/components/gatus/config_flow.py Outdated

Comment thread tests/components/gatus/test_binary_sensor.py

Comment thread homeassistant/components/gatus/config_flow.py Outdated

Fix typos

85067a9

Copilot AI reviewed Jul 10, 2026

View reviewed changes

Comment thread homeassistant/components/gatus/manifest.json

Implement copilot feedback

27bbb80

Copilot AI reviewed Jul 10, 2026

View reviewed changes

Comment thread homeassistant/components/gatus/quality_scale.yaml

joostlek requested changes Jul 10, 2026

View reviewed changes

Comment thread tests/components/gatus/test_init.py Outdated

Increase usage of mock_config_entry

a9493b4

Copilot AI reviewed Jul 10, 2026

View reviewed changes

Trigger CI

7c9439a

Copilot AI reviewed Jul 14, 2026

View reviewed changes

Comment thread homeassistant/components/gatus/coordinator.py

joostlek approved these changes Jul 14, 2026

View reviewed changes

Comment thread homeassistant/components/gatus/binary_sensor.py Outdated

joostlek added 2 commits July 14, 2026 17:18

Update homeassistant/components/gatus/binary_sensor.py

def75d8

Merge branch 'dev' into gatus

83cb680

Copilot AI reviewed Jul 14, 2026

View reviewed changes

Comment thread homeassistant/components/gatus/binary_sensor.py

Comment on lines +101 to +105

"""Return the most recent monitoring result (Gatus appends newest last)."""

results = self.endpoint_data.results

if not results:

return None

return results[-1]

Uh oh!

Uh oh!

Conversation

TN-1 commented Jun 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Proposed change

Type of change

Additional information

Checklist

Uh oh!

home-assistant Bot left a comment

Choose a reason for hiding this comment

Uh oh!

home-assistant Bot commented Jun 29, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

TN-1 commented Jun 29, 2026 •

edited

Loading