koji-resubmit
Resubmit Koji builds
TLDR
Resubmit a task
Resubmit a task without waiting for it to finish
Resubmit a task without printing task information
Display help
SYNOPSIS
koji resubmit TASK_ID [HOST] [options…]
PARAMETERS
TASK_ID
Required ID of the task to resubmit (from koji taskinfo)
[HOST]
Optional target builder host
--arch ARCHS
Restrict to specific architectures
--background
Run the resubmitted task in background
--force
Allow resubmitting successful or active tasks
--priority PRIO
PRIO as low/normal/high to set task priority
--quiet
Suppress non-essential output
--scratch
Resubmit as non-permanent scratch build
--help
Display usage help
DESCRIPTION
The koji resubmit command is part of the Koji CLI tools, used in distributed build systems like Fedora's for RPM package building, testing, and management. It resubmits a previously failed, canceled, or aborted task back into the queue for re-execution, helping developers retry builds after fixing source issues, dependency problems, or transient host failures.
Specify the unique task ID (from koji taskinfo or logs) as the primary argument. Optionally target a specific builder host, adjust priority, or mark as a scratch build (ephemeral, not saved to repo). By default, it only resubmits non-successful tasks; use --force for others.
Requires Koji client setup with hub/server URLs in ~/.koji/client.cfg and authentication (e.g., Kerberos). Output includes the new task ID. Ideal for CI/CD pipelines or manual intervention in large-scale builds.
Limits automation errors without re-uploading sources, leveraging Koji's tag/host scheduling.
CAVEATS
Requires Koji client authentication and hub permissions; defaults to failed/canceled tasks only; scratch builds don't update package repos; use cautiously to avoid queue spam.
EXAMPLES
koji resubmit 12345
koji resubmit 12345 builder.example.com --priority high --scratch
koji resubmit 12345 --force
CONFIGURATION
Edit ~/.koji/client.cfg for server, weburl, topurl. Authenticate via kinit or koji call session.
HISTORY
Koji project started in 2007 by Fedora Infrastructure for mock-based RPM builds. The resubmit subcommand added early (~2008) in koji-cli evolution, with options like --scratch and --priority refined in 2010s updates for better scalability in EPEL/RHEL/CentOS ecosystems.
SEE ALSO
koji(1), koji-taskinfo(1), koji-build(1), koji-wait-repo(1)


