From Fedora Project Wiki

Koji Build System

The Koji Build System is Fedora's buildsystem for Fedora 7 and beyond. Packagers use the koji client to request package builds and get information about the buildsystem. Fedora Release Engineering uses koji to tag builds and coordinate updates/releases.


Fedora package maintainers will want to have the koji package installed on their systems, otherwise, they will be unable to request builds. The koji package is included in the Fedora repositories.

Web Interface

In addition to the commandline tool (koji), there is a web-interface available at [1] .

Fedora Certificates

Koji uses three certificates:

  • .fedora.cert (specific to the Fedora Maintainer) This cert is generated from this form .
  • .fedora-upload-ca.cert (The certificate for the Certificate Authority used to sign the user keys.) It can be downloaded from here .
  • .fedora-server-ca.cert (The certificate for the Certificate Authority used to sign the buildsystem's server keys.) It can be downloaded from here .

All of these certificates should be in your homedir (~).

Koji config

The local client configuration file for koji is /etc/koji.conf. You should not need to change this from the defaults for building Fedora packages.

Example Commands

Some examples of common use of the koji client:

  • Listing jobs:
koji list-tasks
  • Listing only your jobs:
koji list-tasks --mine
  • enqueing a job: general syntax is: koji build [options] target URL:
koji build devel 'cvs://'
  • requeuing an already-processed job: general syntax is: koji resubmit [options] taskID
koji resubmit 3

Makefile aliases

For simple build requests, there is an alias in Makefile.common to request koji builds. This enables Fedora packagers to simply cd into the appropriate branch of a package (from a cvs checkout), and run:

make build

This will trigger a build request for the branch. Easy!

Note that all build requests need to be done against tagged trees (run make tag first).