Raspberry Pi/Quick Install Guide

Installing Gentoo onto a Raspberry Pi is relatively straight forward and in some ways easier than installing Gentoo on another system because a kernel image is provided by the Raspberry Pi Foundation. This means Gentoo can be installed quickly onto a Raspberry Pi.

This quick install guide presumes the reader will be installing from a Linux based operating system.

Preparing the SD card
The Raspberry Pi boots off a FAT32 partition. It will also require root and swap partitions.

Create the partitions
Use the fdisk utility to create the partitions:

Create the file systems
When using a 4GB SD card:

Installation
The installation will be preformed onto the SD card.

Extract stage 3 image
For Raspberry Pi A, A+, B, B+:

For Raspberry Pi 2:

Install kernel and modules
The Raspberry Pi Foundation maintains a branch of the Linux kernel that will run on the Raspberry Pi, including a compiled version which we use here:

Edit fstab
Edit the file to match the previously created partition scheme:

Set boot options
Create a file called in  to pass options to the kernel:

Edit make.conf
The default includes basic CFLAGS. To change the settings to something more 'optimal' for the Pi look at the details on the relevant wiki page.

Configure time zone
View a list of time zones using this command:

Choose the appropriate time zone. Note that some of the listings in the directory are folders that contain more specific time zones. For example, supposing Europe/London is the local time zone:

Next set the timezone:

Clear root password
As chroot was not performed before booting, the root password needs to be unset. Allowing login with a blank password for the root user.

Edit the line for root so it looks like the example below.

Unmount the SD card and boot the Raspberry Pi
Unmount the SD card:

Plugin the SD card to the Raspberry Pi, make sure there is a keyboard and monitor plugged in, then connect the power supply. Hopefully Gentoo will boot displaying a login prompt, login as root and no password. During the first boot there could be a few warnings and errors which can be fixed in the next section.

Set root password
Immediately set a root password:

Enabling networking on boot
Assuming the use of DHCP on the eth0 network interface.

NOTICE: Now copy net.lo, a symlink doesn´t work!

Please also note that may need to be run, as follows

to force an update of the dependency tree. This may be needed in the event of clock skew (in this specific case the eth0 device will not start up after reboot).

Select profile
List the available profiles.

Select the desired profile, for example [25] default/linux/arm/13.0/armv6j:

Configuring inittab and rc.conf
Uncomment the linux specific rc.conf rc_sys value, to stop warning in boot up.

Comment out the s0 Serial console to stop "INIT: Id "s0" respawning too fast" messages on the console.

Enable software clock
The Raspberry Pi does not have a hardware clock, so the hwclock daemon needs to disabled, then swclock can be enabled to mitigate the issue.

The date still needs to be set beforehand to install any package, or in the compiling phase there could be warnings about clock skew. Check system time using date command.

If the date/time displayed is wrong, update it using the date MMDDhhmmYYYY syntax (Month, Day, hour, minute and Year). At this stage, the timezone that was set before in the Configure time zone section should be used. For instance, to set the date to May 02th, 04:21 in the year 2013:

Now it is possible to set the system time using NTP software to setup the system clock on boot.

Overclocking
It is very easy to overclock a Raspberry Pi up to 1000MHz without affecting the warranty

Enabling Overclocking
To enable overclocking select one of the suggest modes from the list above, "Medium" is generally a good starting point. Edit the /boot/config.txt, add the appropriate values and reboot the Raspberry Pi for changes to take effect.

Optional cpupower
To manage the CPU frequency scaling, use the.

The default scaling governor can be changed in the /etc/conf.d/cpupower file

Confirm the current scaling and CPU using the cpupower command

Force Turbo Option
The force turbo option turns off the dynamic clocks and runs the Raspberry Pi constantly at the highest arm_freq.  Edit the /boot/config.txt, add force_turbo=1 then reboot the Raspberry Pi for changes to take effect.

Changing memory split
Not strictly speaking overclocking, but the memory used by the GPU can be changed. To change the memory used by the GPU down to a minimum of 16MB add the gpu_mem value to /boot/config.txt, then reboot the Raspberry Pi for changes to take effect.

Cross building (Optional)
This is not strictly required, but it is extremely practical given the source driven nature of Gentoo. Building almost anything on the Raspberry Pi takes a very, very long time - especially when there are a lot of dependencies involved.

Fortunately, much of the heavy lifting work can be offloaded to a more powerful system (such as a another gentoo desktop/server) using crossdev and distcc (though this will only work for packages must compile c/c++).

Full details of using distcc and crossdev on the Raspberry Pi are described in Raspberry Pi Cross building.

Hardware Random Number Generator
The Arch Wiki tells us that the Raspberry Pi has a hardware random number generator.

Hooking it up to /dev/random is done via the following steps.

Apply settings in /etc/conf.d/rngd
Add the following to /etc/conf.d/rngd

Check that /dev/random is slow
To verify that we have done everything correctly, open a new terminal and do: It will start displaying gibberish (random) but will stop at some point or at least slow down. Now issue CTRL+C to stop it.

Test if it works
Again, issue: in another terminal. Now the random information should be flowing faster than the first time around. Now issue CTRL+C to stop it.

On an idling Pi (networked via a Wi-Fi USB dongle, a USB keyboard attached, display connected) /dev/random spews 4-5 "chars" of random information before it blocks. After loading the module and starting rng-tools, it began printing out many lines without blocking.

Add rng-tools to boot
If all is good, add rngd to boot.

Add loading of bcm2708-rng to boot
Add the following to /etc/conf.d/modules so that the module gets loaded at boot

Install Video Core Userland tools and libraries
The ARM side libraries for interfacing to Raspberry Pi GPU are included in a package raspberrypi-userland. Which includes the Video Core tools, GLES2, EGL, openmax and openVG libs that support the Raspberry Pi GPU.

Then optionally add the following to the shellrc (.bashrc/.zshrc) file to be able to call things like vcgencmd directly.

External resources

 * Gentoo Embedded Handbook with more information about embedded hardware, cross compiling and other related topics.
 * Raspberry Pi Hub at eLinux wiki, with more advanced tutorials to get the most out of the Raspberry Pi