LinuxCommandLibrary

copr

Build and manage custom software repositories

TLDR

View documentation for the original command

$ tldr copr-cli
copy

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)

Copied to clipboard