copr
Build and manage custom software repositories
TLDR
View documentation for the original command
SYNOPSIS
copr [global-options] <subcommand> [<options>]
PARAMETERS
-c --config-dir DIR
Use custom config directory (default: ~/.config/copr)
-h --help
Show help for command or subcommand
-q --quiet
Suppress non-essential output
-d --debug
Enable debug logging
-v --verbose
Increase verbosity level
-V --version
Display copr-cli version
--ignore-errors
Continue on non-fatal errors (some subcommands)
DESCRIPTION
The copr command provides a command-line interface to Copr, a free build service hosted by the Fedora Project for creating custom RPM repositories. Copr allows developers to build, test, and distribute RPM packages across multiple Fedora releases, RHEL, CentOS, and EPEL versions without needing personal build infrastructure.
Users can create projects, submit sources (SRPM, spec+sources, Git URLs, or tgz), monitor builds in various chroots, and enable repositories on client systems via DNF or Yum plugins. It's ideal for packaging software not in official repos, continuous integration, or personal package testing.
Key workflows include submitting builds with copr build, checking status, listing projects, and managing local repos. Authentication uses username/password or API tokens stored in config files. Copr handles mocking, signing (optional), and modular builds, making it a powerful alternative to Koji for non-official packages.
Requires the copr-cli package; supports both interactive and scripted use.
CAVEATS
Requires copr-cli package and internet access. Some operations need Copr account and API token. Builds can take time; not for production repos. Rate limits apply for anonymous use.
COMMON SUBCOMMANDS
build: Submit sources to build.
status: Check build/project status.
list: List projects/builds.
choose-repo: Enable/disable project repo.
remove: Delete project/build.
CONFIG SETUP
Edit ~/.config/copr/copr.conf with [copr-cli] section for username, token. Use copr-cli setup interactively.
EXAMPLE
copr build user/project path/to/sources.rpm
Enables repo: copr enable user/project
HISTORY
Developed by Michal Toman and Copr team around 2014 as part of Fedora infrastructure. Evolved from mock-based systems; major versions align with copr-cli releases (e.g., v1.80+ in 2020s). Actively maintained for Fedora 40+.
SEE ALSO
mock(1), rpmbuild(8), dnf(8), createrepo(8)


