koji-untag-build

Remove a tag from one or more builds

$ koji untag-build [tag] [NVR1 NVR2 ...]

$ koji untag-build [tag] [pkg1 pkg2 ...] --all

$ koji untag-build [tag] [pkg1 pkg2 ...] --non-latest

$ koji untag-build [tag] [NVR1 NVR2 ...] [[-n|--test]]

$ koji untag-build [tag] [NVR1 NVR2 ...] [[-v|--verbose]]

$ koji untag-build [[-h|--help]]

koji-untag-build [options] <tag> <buildglob> [<buildglob> ...]

--force
    Force removal even if build present in generated repo (use with caution)

--help, -h
    Display usage summary

--cfg=FILE
    Configuration file location

--server=URL
    Koji hub server URL

--proxy=PATH
    Path to XML-RPC proxy file

--user=USER
    Username for authentication

--password=PASS
    Password (interactive if omitted)

--ticket=TOKEN
    KrbV ticket

--debug
    Enable debug output

--quiet
    Suppress non-error messages

The koji-untag-build command is part of the Koji build system, used in Fedora and similar RPM-based distributions for managing package builds. It removes one or more specified tags from a build, disassociating the build from those tags.

This action updates the tag's build list, potentially triggering repo regeneration. Builds are identified by NVR (Name-Version-Release), and wildcards are supported for buildglob. Commonly used by package maintainers to retract builds from testing or release tags.

Koji ensures builds are properly tagged for different environments like rawhide, updates-testing, or stable. Untagging cleans up erroneous or superseded builds without deleting them. Requires authentication and appropriate permissions on the Koji hub.

Typical workflow: build package, tag to testing (koji tag-build), test, then promote or untag as needed.

Requires Koji admin or tag ownership permissions. --force bypasses repo checks but risks repo inconsistency. Wildcards may untag unintended builds; verify with koji list-tagged. Does not delete build archives.

koji-untag-build updates-testing mypkg-1.0-1.fc30
Removes 'mypkg-1.0-1.fc30' from 'updates-testing' tag.

koji-untag-build dist-6E '*.fc30'
Untags all fc30 builds from dist-6E (with caution).

User must own the build or have 'untag' capability on the tag. Check with koji list-permissions.

Koji developed by Fedora Project's Infrastructure team starting ~2006, replacing older Plague system. untag-build subcommand added early for build lifecycle management. Widely used in Fedora, CentOS, RHEL, EPEL.

koji tag-build, koji list-tagged, koji build, koji list-builds