The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.
Funtoo Metro Project
metro, the framework used to create new Funtoo Linux builds.Metro now has a new Initial Setup guide, which explains how to use the totally rewritten (and reliable) setup tool.
10 October 2022
Introduction
Metro is the tool used by Funtoo Linux to build new releases of Funtoo Linux. It is also available to the public and can be used to build custom versions of Funtoo Linux, or used by developers to perform build testing. This page documents how to install, configure and use Metro. Also note that there is various additional supplemental documentation available on sub-pages, with links above.
Installation
Prerequisites
Ensure that dev-vcs/git, dev-python/requests, dev-python/sqlalchemy and dev-python/lxml are installed on your system.
root # emerge dev-vcs/git dev-python/requests dev-python/sqlalchemy dev-python/lxml www-servers/tornado sys-apps/fchroot
Using AutoSetup
You can skip all the remaining steps in this session by using the automatic setup script.
Prerequisites for QEMU Support
Metro now supports building arm-32bit and arm-64bit stages on x86-64bit systems, using qemu. To enable this functionality, it is necessary to emerge No results with the following settings.
First, add the following to/etc/portage/package.use:
/etc/portage/package.use app-emulation/qemu static-user
dev-libs/glib static-libs
sys-apps/attr static-libs
sys-libs/zlib static-libs
dev-libs/libpcre static-libs
Next, the following should be added to /etc/make.conf:
/etc/make.conf QEMU_USER_TARGETS="aarch64 arm"
Then, emerge qemu:
root # emerge app-emulation/qemu
From this point forward, support for ARM on x86 systems should work transparently. Metro will take care of compiling a wrapper for qemu and temporarily installing the static version of qemu inside the stage chroot so that ARM binaries will run transparently on x86 systems. Metro will also automatically register qemu as a "binary format" with the kernel.
Cloning Metro
The recommended and supported method for installing metro is to clone metro's git repository to /root. Clone the master git repository as follows:
root # cd /root root # git clone https://code.funtoo.org/bitbucket/scm/core/metro.git root # cp /root/metro/metro.conf ~/.metro
The /root/.metro file contains the system metro configuration, and defines where the build repository and other files should be stored. Defaults are typically fine for most users, and /home/mirror/funtoo will be used as the build repository path. For more information on configuration settings available, see Configuring Metro.
You will now have a directory called /root/metro that contains all the Metro source code.
Setting up ego
Now, we will set the ego, administration tool of Funtoo Linux. The way it is used with metro is independent from app-admin/ego installed on your box. This local cloned copy of ego allows metro to potentially use a newer version of ego than what is already installed on your system, or to function under other non-Funtoo distributions like Gentoo or Ubuntu. Set up as follows:
root # cd /root root # git clone https://code.funtoo.org/bitbucket/scm/core/ego.git
This way you will have /root/ego directory with ego binary that is then used by metro.
Build Repository Setup
Metro uses a repository to store built stages and snapshots, which typically resides at /home/mirror/funtoo. There are two methods to set up your build repository -- it can be done manually or with our auto-setup script. The auto-setup script is of course faster and easier, while the manual method may give you a deeper understanding of how the build repository internals work.
First Build
Once your build repository has been set up, you can start your first build using a command similar to the one below:
root # /root/metro/scripts/ezbuild.sh 1.4-release-std x86-64bit amd64-zen full