@@ -660,6 +660,36 @@ A subproject can be enabled on a user system with::
660
660
dnf copr enable frostyx/test:custom:foo
661
661
662
662
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
+
663
693
Modularity
664
694
----------
665
695
0 commit comments