homarr/CHANGES.md

Changes

Goal

Remove widget-only services from Homarr's global Integration system.

The affected services are release providers, Search.ch, and ArchiveTeam Warrior. They are only used by specific widgets, so keeping them as global integrations added unnecessary setup, UI, database rows, docs pages, and integration package code.

Why

These services do not need shared integration state.

• Release providers are selected per Releases widget repository.
• Search.ch is only used by the Timetable widget.
• ArchiveTeam Warrior is only used by the ArchiveTeam Warrior widget.

Moving them into widget options makes configuration simpler and removes dead-weight integration code from packages/integrations.

What Changed

Release Providers

• Added release provider definitions in packages/definitions/src/release-provider.ts.
• Removed release providers from IntegrationKind.
• Moved release-fetching code out of packages/integrations and into packages/request-handler/src/release-providers.ts.
• Updated the Releases widget to store provider configuration directly in widget options:
  • provider
  • identifier
  • versionFilter
  • providerUrl
• Updated the Releases widget editor to use a provider select instead of an integration select.
• Updated Docker import mapping so ghcr.io maps to gitHubContainerRegistry.
• GitHub Container Registry now uses the public OCI registry API and accepts full image references such as ghcr.io/homarr-labs/homarr:latest.

Timetable / Search.ch

• Removed Search.ch as an integration.
• Added a Timetable widget baseUrl option, defaulting to https://search.ch.
• Moved Search.ch request/parsing logic into packages/request-handler/src/timetable.ts.
• Updated the Timetable API to receive baseUrl directly from widget options.

ArchiveTeam Warrior

• Removed ArchiveTeam Warrior as an integration.
• Added an ArchiveTeam Warrior widget url option, defaulting to http://localhost:8001.
• Moved ArchiveTeam Warrior status/WebSocket handling into packages/request-handler/src/archive-team-warrior.ts.
• Updated the widget API and component to use the widget url option.

Integration Cleanup

• Removed creators, exports, docs references, and implementation files for the deleted integrations.
• Removed unused dependencies from packages/integrations/package.json.
• Added required request-handler dependencies for the moved WebSocket logic.

Database Migration

• Added packages/db/migrations/custom/0003_remove_widget_only_integrations.ts.
• The migration moves old integration-linked widget config into widget options, then deletes the old widget-only integration rows.
• Updated the earlier release widget migration to use the new provider field instead of providerIntegrationId.

Docs

• Updated Releases widget docs to describe providers instead of integrations.
• Updated Timetable docs to remove Search.ch integration setup.
• Removed obsolete integration docs pages for the deleted integration kinds.
• Updated docs sitemap and integration docs mappings.

Translations

• Added English labels for the new widget options:
  • widget.archiveTeamWarrior.option.url.label
  • widget.timetable.option.baseUrl.label
  • widget.releases.option.repositories.providerUrl.label

How It Works Now

Release provider configuration lives on each Releases widget repository entry. The request handler resolves provider metadata and fetches releases directly from the provider-specific endpoint. GHCR uses anonymous OCI registry access for public packages.

Timetable and ArchiveTeam Warrior now pass their widget URL options directly to their API routers and request handlers. No global integration lookup is needed.

Deliberate Non-Goals

• No provider secret/token support was added.
• No new secret storage model was introduced.
• No compatibility layer was kept in packages/integrations.

Widget options are client-visible, so storing provider credentials there would be wrong. If authenticated provider requests are needed later, they need a separate secret-storage design.

Verification So Far

• Focused typechecks passed for affected packages.
• Full pnpm turbo typecheck passed.
• Full pnpm lint passed with existing warnings.
• Focused release provider normalization tests passed.
• Widget translation test passed.
• Live GHCR smoke checks passed for ghcr.io/muchobien/pocketbase:latest and ghcr.io/homarr-labs/homarr:latest.
• pnpm test packages/integrations/test/pi-hole.spec.ts passed earlier, but failed on rebased reruns because Pi-hole reported domainsBeingBlocked as -2/0 instead of > 1.