COPA(1)

NAME
copa - DNF5-style Fedora Copr Package Assistant

SYNOPSIS
copa [OPTIONS] COMMAND [ARGS...]

DESCRIPTION
copa is a Copr package assistant for the Fedora / DNF5 ecosystem, providing a search and install experience similar to paru/yay on Arch, but with DNF-style command format.

Supported package sources:

    •   Fedora official repos

    •   RPM Fusion

    •   Terra

    •   Copr (Fedora community build service)

    •   openSUSE OBS (cross-distro build service)

GLOBAL OPTIONS

-V, --version
    Show version and exit.

--json
    Output in JSON format.

-h, --help
    Show help message and exit.

COMMANDS

  search
Search Copr and OBS by default. OBS is searched only when available. Add --include-local-repo to also search Fedora, RPM Fusion, and Terra.

    copa search [OPTIONS] KEYWORD [KEYWORD...]

Options:

--include-local-repo
    Also search Fedora, RPM Fusion, and Terra.

--official-only
    Search Fedora official repos only.

--rpmfusion-only
    Search RPM Fusion only.

--copr-only
    Search Copr only.

--obs-only
    Search OBS only.

--no-obs
    Skip OBS search.

Multiple keywords use AND logic (all words must match).

  install
Install a package.

    copa install [OPTIONS] PACKAGE

Options:

--official-only
    Install from Fedora official repos only.

--rpmfusion-only
    Install from RPM Fusion only.

--copr-only
    Install from Copr only.

--copr OWNER/PROJECT
    Use specified Copr repo.

--obs-only
    Install from OBS only.

--no-obs
    Skip OBS search.

--allow-obs-fallback
    Allow OBS version fallback.

--keep-copr
    Keep Copr repo after install.

--dry-run
    Show operations without executing.

-y, --assumeyes
    Auto confirm.

  info
Show package information.

    copa info PACKAGE

  list
List packages or repos.

    copa list [--packages OWNER/PROJECT]

  repo
Manage third-party repos (Copr/OBS).

    copa repo list
        List all third-party repos.

    copa repo enable REPO
        Enable repo. Format: copr:owner/project or obs:project.

    copa repo disable REPO
        Disable repo.

    copa repo remove REPO
        Remove repo.

  doctor
Check system environment and dependencies.

    copa doctor

  audit
Audit enabled repos for issues.

    copa audit

EXAMPLES

copa search ghostty
    Search for ghostty in Copr and OBS.

copa search --include-local-repo ghostty
    Search for ghostty in Copr, OBS, and local repos.

copa search ghostty terminal
    Search for packages matching both "ghostty" and "terminal".

copa install ghostty
    Install ghostty interactively.

copa install --copr rivenirvana/ghostty ghostty
    Install ghostty from specified Copr repo.

copa install --dry-run ghostty
    Preview installation without executing.

copa repo list
    List all third-party repos.

copa repo disable copr:owner/project
    Disable a Copr repo.

FILES

~/.config/copa/config.toml
    User configuration file.

~/.local/share/copa/state.json
    State file recording repos managed by copa.

EXIT STATUS

0   Success.

1   Error.

130 Interrupted by user (Ctrl+C).

SEE ALSO
dnf(8), dnf5(8), copr-cli(1), osc(1)

AUTHORS
copa contributors.

LICENSE
GPL-2.0-or-later