Building modules in Copr
Copr ("Community projects") is a service that builds your open-source projects and creates your own RPM repositories. Read the documentation to find out more or see it in action here.
There are multiple ways how to build modules in Copr and it is up to each user to choose the most suitable one for their specific use-case.
Do you know what modulemd yaml file is and do you have it written for your module? Then submit an existing modulemd yaml to Copr.
Do you have a Copr project providing some RPM packages and want to make module from them? Then don’t write a modulemd yaml file manually and generate it from a Copr project.
Discover more advanced topics such as requiring Copr packages from an existing modulemd yaml file, depending on modules from Copr, and overriding module packages by regular ones.
Copr is a third-party service with its own implementation of the module build process. It does not rely on the Module Build Service and it is not governed by Fedora Modularity team. As a consequence, some features might behave differently.
Some features are also in rather experimental or proof-of-concept state (e.g. depending on other Copr modules) and therefore might be cumbersome to use. Feedback from users is more than welcome and it is the deciding factor of what is going to be implemented or improved. Please submit your requests to pagure issue tracker.
Additionally, only version 1 of the modulemd format is supported. Version 2 is not supported yet (with an exception of version 2 files that are compatible with the older format).
Submit an existing modulemd yaml
Currently, there is no web UI for submitting a module build from an existing modulemd yaml file.
The only way is to use
copr-cli package. Make sure it is installed.
dnf install copr-cli
And make sure that an API token is properly configured.
To submit a build from locally stored modulemd yaml file, use:
copr-cli build-module --yaml /some/path/testmodule.yaml <COPR project name>
If the modulemd yaml file is available on a URL accessible for public, use following:
copr-cli build-module --url https://example/some/path/testmodule.yaml <COPR project name>
To specify a different project owner (e.g. when building into a group project), use:
copr-cli build-module --yaml /some/path/testmodule.yaml @mygroup/testmodule
For more information, see
copr-cli build-module --help or
Generate modulemd from a Copr project
This method aims to provide modularity features with the lowest entry barrier possible. It doesn’t demand a user to know either how to write modulemd yaml file nor using the command line. The only prerequisite is to have a Copr project with some package successfully built in it.
Open your project, click on
Modules, then click to
New Module. The input page looks like this.
It provides a list of all successfully built packages in the project. By default, they are all selected to become part of the module. Uncheck those that are not wanted. Optionally specify a module API or its profiles.
Modules with Copr packages
It is trivial to achieve when generating modulemd from Copr project. This section describes a special case of how to add a Copr package into an existing custom modulemd yaml file.
components.rpms section and add a new package definition.
hello: rationale: Showing how to use a package from Copr ref: ... repository: ...
… placeholders need to be replaced with real values. Open a web browser and navigate
to a build detail whose results should be used by the module. The build needs to be finished
successfully. Scroll down to the
Use the hash value from the
Dist Git Sourcecolumn as a
refin the modulemd.
Follow the link of the
Dist Git Sourcevalue to a Copr distgit instance. Use the URL as a
repositoryin modulemd - with some small adjustments.
Trim everything after
To avoid confusion, here are some example values.
hello: rationale: Showing how to use a package from Copr ref: 9d1ced1 repository: http://copr-dist-git.fedorainfracloud.org/git/frostyx/hello/hello.git
Modules in Copr as dependencies
At this moment, Copr doesn’t properly parse module dependencies from modulemd yaml file. They need to be explicitly enabled in the project settings - more precisely chroot settings within a project.
When the dependency comes from Fedora repositories, simply edit
Enable module field and append
the module in
If the dependency was built in Copr, it is necessary to edit also the
Repos field and provide a
repository URL from which the module can be installed. See the Installing modules from Copr
section to learn how to find a repofile for a module (in this case the module that is used
as a dependency). Use it’s
baseurl as the value for
Installing modules from Copr
dnf copr plugin does not support enabling module repositories and therefore it needs to
be done manually. Navigate to a Copr project in a web browser, see the
Modules page, and open
detail of a module that is to be installed. If the build is still running, wait until it
finishes. For successfully built modules, a "How to use" section is displayed. Follow its
instructions. After that, standard DNF commands for manipulation with modules can be used.
Override module packages
The package version resolution was straightforward in the pre-modularity era. If multiple repositories provided the same package, the one with the highest version was preferred. It is more complicated now. If there is a module stream enabled within the system and this stream provides a package, it is preferred over its non-modular variant regardless of its version.
To suppress this behavior,
module_hotfixes repositories were invented. For them, DNF upgrades to a
higher version of a package regardless of where it comes from. Enable them in Copr by going to
project settings and turning on this checkbox.
[ ] This repository contains module hotfixes This will make packages from this project available on along with packages from the active module streams.
Or in a command line
copr-cli modify frostyx/foo --module-hotfixes on
Build a module from a modulemd yaml file hosted online:
copr-cli create testproject1 --chroot fedora-rawhide-x86_64 copr-cli build-module testproject1 \ --url https://src.fedoraproject.org/modules/httpd/raw/2.4/f/httpd.yaml
Alternatively, build a module from a localy stored modulemd yaml file:
fedpkg clone -a modules/httpd cd httpd copr-cli create testproject2 --chroot fedora-rawhide-x86_64 copr-cli build-module testproject2 --yaml httpd.yaml
Want to help? Learn how to contribute to Fedora Docs ›