Set-up.md

Set-up

WARNING: Very recently some changes were pushed to Pentoo which moved the Pentoo Overlay from /var/lib/layman to /var/db/repos.

Introduction

Pentoo Linux can be used as an overlay bringing a full set of tools and settings to an existing stable Gentoo setup.

Adding the overlay

Update the portage to the latest version

emerge --sync

Make sure that layman and subversion are installed

emerge app-portage/layman subversion 

Update list of overlays

layman -L

Add Pentoo overlay

layman -a pentoo

Add proper keywords/use flags and other settings. There are 3 options:

Option 1: Use one of Pentoo profiles

List all available profiles

eselect profile list

Select an appropriate Pentoo profile for your current setup

eselect profile set pentoo:pentoo/hardened/linux/amd64

Option 2: Use the "overlay" subprofile (gentoo profile + keywords/use files)

Remove an old profile

rm /etc/portage/make.profile
mkdir -p /etc/portage/make.profile

Create the /etc/portage/make.profile/parent file with the following context:

gentoo:default/linux/amd64/17.1/hardened
gentoo:targets/desktop/
pentoo:pentoo/overlay

switch to that profile

env-update && source /etc/profile 

Option 3: Manual

Create symlinks for necessary keywords/use files:

ln -s /var/lib/layman/pentoo/profiles/pentoo/base/package.accept_keywords/net-analyzer /etc/portage/package.keywords
ln -s /var/lib/layman/pentoo/profiles/pentoo/base/package.use/dev-ruby /etc/portage/package.use

Check changes and adjust other settings if required See the next section for examples

emerge -DNupv world

Install the entire Pentoo

emerge -DNu pentoo

or choose a separate package

emerge -DNu pentoo-wireless

Adjusting settings

To merge the overlay with your current setup smoother, additional changes can be made in a usual Gentoo way by modifying files in the /etc/portage directory. For example, you can disable additional wireless drivers by adding a file to the /etc/portage/package.use/ directory with the following content:

pentoo/pentoo -bluetooth
pentoo/pentoo-wireless -drivers

and disable unrequired global flags in the make.conf file:

USE="-bluetooth -gps -caps -livecd -ldap"

See the official Gentoo handbook for more details