Skip to content

enable disable

GitHub Actions edited this page Jun 1, 2026 · 2 revisions

Enable and Disable

You will learn how to enable and disable feeds and artifact parents, what happens to dependent feeds, and how enable state persists across restarts.

Feeds and artifact parents are independent

You enable and disable feeds and artifact parents separately. Disabling a feed does not disable its artifact parent. Disabling an artifact parent operationally disables its children.

Disabled feeds

When you disable a feed:

  • The scheduler removes it from the download queue.
  • Automatic downloads or compositions stop.
  • Automatic processing stops.
  • Existing published artifacts remain in place.
  • The feed still appears in the admin UI with its disabled state visible.

Manual feed actions are explicit operator requests. Feed-level Recheck and Reprocess can still force the selected feed's own enable marker for that one action when local prerequisites exist. Parent constraints still apply: an artifact-backed child still needs its artifact parent enabled, and a history derivative still needs an enabled parent.

Effect on merges

Merges compose from their enabled inputs. Disabling an input changes merge behavior:

Input type Effect of disabling
Additive input disabled The input is excluded from composition. If no additive inputs remain eligible, the merge is operationally disabled.
Subtractive input disabled The merge fails composition. This is a safety behavior — it prevents the published set from silently broadening.

A subtractive input that is disabled, archived, unmaintained, or missing causes the merge to fail rather than producing a broader set than intended.

Health exclusion is role-sensitive: archived or unmaintained additive inputs are skipped, while archived or unmaintained subtractive inputs fail the merge as a safety stop.

Artifact parents and children

An artifact-backed child feed is operationally enabled only when both conditions are true:

  • The child itself is enabled.
  • The artifact parent is enabled.

Disabling the parent disables all its children operationally, even if the children remain individually marked as enabled. Children cannot control whether the parent is enabled.

History derivatives

A history derivative follows its parent. If the parent is disabled, the derivative is operationally disabled.

Enable all

The --enable-all flag enables all known feeds at startup. This is useful for initial setup or when you want the daemon to manage every feed in the catalog.

update-ipsets daemon --enable-all

This flag is a global runtime override. The current daemon does not use the catalog enabled_by_all field to exclude sources from --enable-all.

Persistence

Enable state persists across daemon restarts via marker files on disk. When the daemon restarts, it reads the markers and restores each feed to its last known enable state.

You do not need to re-enable feeds after a restart.

Provider databases

Provider databases follow the same enable/disable semantics as normal feeds.

When a provider database is disabled:

  • The downloader stops refreshing it.
  • The processing engine stops using newly refreshed data.
  • Previously published artifacts from older provider data remain authoritative until later publication replaces them.

See also

Getting Started

Installation

Running the Daemon

Configuration

Feed Configuration

Pipeline

Admin UI

Integrity

API Reference

Monitoring

CLI Tools

Troubleshooting

Updating

Catalog Maintenance

Security

Reference

Clone this wiki locally