Skip to content

Commit 8b443a9

Browse files
committed
doc: explain custom chroots
Fix #3226
1 parent 2e4dce9 commit 8b443a9

File tree

1 file changed

+30
-0
lines changed

1 file changed

+30
-0
lines changed

doc/user_documentation.rst

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -660,6 +660,36 @@ A subproject can be enabled on a user system with::
660660
dnf copr enable frostyx/test:custom:foo
661661

662662

663+
Custom chroots
664+
--------------
665+
666+
Copr builds RPM packages for many distributions and their versions. It is up
667+
to the project owners to enable the desired chroots for their projects.
668+
669+
In some advanced cases, it can happen that an appropriate chroot isn't
670+
available. The distribution might be too niche, the chroot config might enable
671+
some undesirable repositories, etc. For this purpose, Copr provides
672+
so-called "Custom chroots". They have only minimal configuration, requiring the
673+
project owner to fill in the gaps.
674+
675+
In a hypothetical scenario where ``fedora-rawhide-x86_64`` chroot doesn't exist,
676+
here is how to re-create it through a custom chroot. First, go to your project
677+
settings and enable ``custom-1-x86_64`` chroot. Then go to the project settings
678+
again, find the chroot and click the ``Edit`` button next to it. Then specify
679+
the list of repositories that should be enabled, in this case::
680+
681+
https://kojipkgs.fedoraproject.org/repos/rawhide/latest/x86_64/
682+
683+
And lastly, specify the list of packages that should be installed to the minimal
684+
buildroot before an RPM package is attempted to be built. Group names are
685+
supported as well. In this case::
686+
687+
@build
688+
689+
You won't need this for Fedora Rawhide, but you can use this exact approach for
690+
any distribution that is not officially supported.
691+
692+
663693
Modularity
664694
----------
665695

0 commit comments

Comments
 (0)