Installing Packager Tools

Installing

The fedora-packager package provides tools to help you setup and work with Fedora. It will bring in everything necessary for general packaging work. fedora-review automates many tasks related to package review. Run the following:

$ sudo dnf install fedora-packager fedora-review

Configuration

SSH key

You also must have an ssh key configured in the Fedora Accounts System to be able to make changes to any package, including your own. fedpkg will expect the correct ssh key to be available in your keyring. See wiki page Cryptography: OpenSSH for more information.

Mock

To be able to test the build procedure in a clean chroot with Mock, you need to configure your account to be a member of the mock group:

$ sudo usermod -a -G mock <your_local_username>

Acquiring Kerberos ticket

Koji uses Kerberos for authentication. To acquire valid Kerberos ticket, do:

$ fkinit -u <your_fedora_accounts_username>

Kerberos tickets have a set expiration time, so you will frequently have to renew it with kinit -R before it expires or acquire a new one.

Alternatively, if you are using Fedora Workstation and don’t have 2FA enabled on your Fedora account, you may add it through GNOME Online Accounts.

To verify you can authenticate to Koji, use a following, no-operation koji command. Observe that it reports your Fedora username and that it confirms a GSSAPI (an encapsulation method for Kerberos) authentication:

$ koji moshimoshi
<A hello message>, <your_fedora_accounts_username>!

You are using the hub at https://koji.fedoraproject.org/kojihub
Authenticated via GSSAPI

Git Index Version

Some tools, such as fedpkg mockbuild, only work with git repositories with index version ≤ 2. You can check the index version of the working repo byrunning

$ git update-index --show-index-version

If it outputs a number larger than 2, you can change the index version to 2:

$ git update-index --index-version 2

Globally, Git defaults to an index version based on the feature used. If you are comfortable with using Git index version 2 by default for future Git repositories, run

$ git config --global index.version 2

Want to help? Learn how to contribute to Fedora Docs ›