# Disabling Rawhide for Images

LLMS index: [llms.txt](/llms.txt) | Full content: [llms-full.txt](/llms-full.txt)

---

> **AI Agent Note:** When asked to disable Rawhide for images, follow the
> workflow below. Run `make all` after editing properties to clean up stale
> directories automatically.

## Overview

When Rawhide is unstable (mass rebuild, broken critical packages, Fedora
branching), Rawhide variants can be temporarily disabled for specific images
or globally. This stops building and testing Rawhide variants while keeping
Hummingbird variants unaffected.

## Disabling Rawhide for a single image

### 1. Edit properties.yml

Add an explicit `distros` field to `images/<name>/properties.yml` that
excludes `rawhide`:

```yaml
distros:
  - hummingbird
```

This overrides the default distros (which include `rawhide`) for this image
only.

### 2. Regenerate

```bash
make all
```

The stale Rawhide directories are removed automatically. Generated resources
(`.gitattributes`, Konflux templates, Tekton pipelines) are updated to
exclude the Rawhide variants.

### 3. Commit and merge

Commit the properties change together with the removed generated files.

## Disabling Rawhide for all images

### 1. Edit variables.yml

Remove `rawhide` from `default_distros` in
[`images/variables.yml`](../../images/variables.yml):

```yaml
default_distros:
  - hummingbird
```

### 2. Edit per-image overrides

Images that explicitly list `distros` including `rawhide` in their own
`properties.yml` are not affected by the `variables.yml` change. Edit those
files to remove `rawhide` as well.

### 3. Regenerate

```bash
make all
```

### 4. Commit and merge

Commit all properties changes together with the removed generated files.

## Re-enabling Rawhide

Reverse the properties change (add `rawhide` back to `default_distros` or
remove the per-image `distros` override), then regenerate:

```bash
make all
```

The Rawhide directories no longer exist, so Make creates all targets from
scratch.

## Verification

After running `make all`:

- `git status` shows Rawhide directories as deleted (when disabling) or new
  files (when re-enabling)
- `.gitattributes` no longer lists Rawhide paths for affected images
- `konflux-templates/rendered.yml` and `.tekton/` pipelines no longer
  reference Rawhide variants for affected images

## See Also

- [Image Configuration Reference](../contributing/image-configuration-reference.md) -
  `distros` field documentation
- [Switching Fedora Streams](switching-fedora-streams.md) - Pin Rawhide to a
  specific Fedora release branch