copr
Build and manage custom software repositories
TLDR
View documentation for the original command
SYNOPSIS
copr [GLOBAL_OPTIONS] COMMAND [COMMAND_OPTIONS] [ARGUMENTS]
Examples:
copr build project_name SRPM_file.src.rpm
copr list --my-projects
copr repo enable project_name
PARAMETERS
--config FILE
Specifies a custom configuration file path instead of the default.
--version
Displays the version information of the copr client.
--help
Shows a help message for the copr command or a specific subcommand if provided.
DESCRIPTION
The copr command (typically executed as copr-cli) is the command-line client for interacting with the COPR (Community PRojects) build system. COPR is a free and open-source automated build service primarily used by Fedora, CentOS, and Red Hat Enterprise Linux users to build and host custom RPM repositories. It allows developers and users to build software packages outside of the official distribution repositories.
The copr client enables users to manage their COPR projects, initiate new builds, monitor build status, manage repositories, and perform user-related actions directly from their terminal. This includes creating new projects, uploading SRPMs (Source RPMs) for building, enabling COPR repositories on their systems for easy installation of built packages, and listing existing projects or builds. It streamlines the process of distributing software that isn't yet, or will never be, part of official distribution channels.
CAVEATS
Requires an active internet connection to communicate with the COPR service.
Requires a COPR account for most operations like building or managing projects.
Primarily focused on RPM-based Linux distributions (Fedora, CentOS, RHEL).
Building untrusted SRPMs can pose security risks, as builds execute in a controlled environment but might consume resources or exploit vulnerabilities if not properly reviewed.
<BR><B>SUBCOMMANDS OVERVIEW</B><BR>
The copr command operates using a subcommand structure. Common subcommands include:
build (to initiate package builds),
create (to set up new projects or objects),
list (to view existing projects, builds, or repositories),
delete (to remove projects or builds),
enable (to enable COPR repositories on your system),
login/logout (for authentication),
monitor (to track build progress), and
repo (to manage repository-specific actions). Each subcommand often has its own set of options and arguments.
<BR><B>INSTALLATION</B><BR>
The copr-cli client is typically installed via the system's package manager on Fedora-based distributions. For example:
sudo dnf install copr-cli
Once installed, it can be invoked as copr or copr-cli depending on the specific environment and PATH configuration.
HISTORY
The COPR build system originated as a community project within Fedora, aiming to provide a flexible and easy-to-use platform for building and distributing software packages outside of the official Fedora repositories. It has evolved significantly since its inception, becoming an integral part of the Fedora ecosystem for testing new software, hosting personal projects, and enabling third-party software distribution. The copr-cli client was developed to provide a robust command-line interface for seamless interaction with the COPR service, reflecting the system's focus on automation and developer workflows.
SEE ALSO
rpm(8), dnf(8), yum(8), createrepo(8), mock(1)