Overlay Configuration

ganto edited this page Dec 4, 2012 · 2 revisions

Setup layman:

# emerge -av layman
# echo "source /var/lib/layman/make.conf" >> /etc/make.conf

Create a new repository .xml file, e.g. /var/lib/layman/freeipa.xml with the following content:

<?xml version="1.0" ?>
<layman>
    <overlay contact = "freeipa@linuxmonk.ch"
             name = "freeipa"
             src = "https://github.com/ganto/freeipa.git"
             type = "git">
        <link>https://github.com/ganto/freeipa</link>
        <description>Inofficial overlay for FreeIPA and related ebuilds</description>
    </overlay>
</layman>

Then extend your layman overlay configuration with the new repository:
# vim /etc/layman/layman.cfg

overlays  : http://www.gentoo.org/proj/en/overlays/repositories.xml
            file:///var/lib/layman/freeipa.xml

Finally you can add the freeipa overlay as another Gentoo repository:
# layman -a freeipa

The ebuilds in the new repository can then be listed e.g. with eix:
# eix-update
# eix -c --in-overlay freeipa

The overlay won't be automatically updated with an emerge --sync. To get the latest ebuilds, you should run:
# layman -S
or
# layman -s freeipa