copr-cli

copr-cli command [options] [arguments]

copr-cli is the command-line client for Fedora's COPR build system. It allows developers to create projects, submit builds, manage repositories, and automate package distribution without using the web interface.
The tool handles the complete package lifecycle: creating projects with specified build targets (chroots), submitting source RPMs for building, monitoring build progress, and downloading the resulting packages. It supports building from local files, URLs, or SCM repositories.
copr-cli is essential for CI/CD pipelines that automatically build and publish packages to COPR. Authentication is handled via API tokens stored in a configuration file, enabling scripted operations.

create NAME

Create a new COPR project.

Submit a build to a project.

List your COPR projects.

Check the status of a build.

Download the built RPMs.

Delete a project.

Specify build target (e.g., fedora-39-x8664, epel-9-x8664).

Build from an SRPM URL instead of local file.

Don't wait for build to complete.

Use alternate configuration file.

~/.config/copr

API token configuration for authenticating with the COPR build system.

Requires a Fedora Account System (FAS) account and API token configured in ~/.config/copr. Build chroots must be enabled for the project before building. Large builds may take significant time; use --nowait for async operation.

copr-cli was developed alongside the COPR build service by the Fedora Project. It provides programmatic access to the same functionality available through the COPR web interface at copr.fedorainfracloud.org, enabling automation and integration with development workflows.

copr(1), rpmbuild(1), mock(1), dnf(1)