LinuxCommandLibrary

copr

Build and manage custom software repositories

TLDR

View documentation for the original command

$ tldr copr-cli
copy

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)

Copied to clipboard