Install/Download and Extract Stage3

Install Guide: Download and Extract Stage3

Install Guide, Chapter 8

< Prev

Next >

Now that filesystems are created and your hardware and system clock are set, the next step is downloading the initial Stage 3 tarball. The Stage 3 is a pre-compiled system used as a starting point to install Funtoo Linux.

To download the correct build of Funtoo Linux for your system, head over to the Subarches page. Subarches are builds of Funtoo Linux that are designed to run on a particular type of CPU, to offer the best possible performance. They also take advantage of the instruction sets available for each CPU.

   Note

We now have a database of all Intel 64-bit CPUs in existence, mapped to the ideal stage3 to download! To view this list, visit Funtoo CPU Database and search for your CPU. A subset of this list now also appears on 64-bit Intel subarch pages.

If you don't know which subarch to choose, issue this command:

root # gcc -march=native -Q --help=target

If you are using a virtualization technology to run Funtoo Linux, and your VM may migrate to different types of hardware, then it's recommended that you use a stage3 that is optimized for the oldest CPU instruction set that your VM will run on, or a generic image if it may run on both AMD and Intel processors.

For most subarches, you will have several stage3s available to choose from. This next section will help you understand which one to pick.

Which Build?

Pick 1.3-release-std. This is release 1.3 of Funtoo Linux, our current release.

Download the Stage3

Once you have found the stage3 that you would like to download, use wget to download the Stage 3 tarball you have chosen to use as the basis for your new Funtoo Linux system. It should be saved to the /mnt/funtoo directory as follows:

root # cd /mnt/funtoo
root # wget https://build.funtoo.org/funtoo-current/x86-64bit/generic_64/stage3-latest.tar.xz

Note that 64-bit systems can run 32-bit or 64-bit stages, but 32-bit systems can only run 32-bit stages. Make sure that you select a Stage 3 build that is appropriate for your CPU. If you are not certain, it is a safe bet to choose the generic_64 or generic_32 stage. Consult the Subarches page for more information.

Once the stage is downloaded, extract the contents with the following command, substituting in the actual name of your Stage 3 tarball:

root # tar xpf stage3-latest.tar.xz

   Important

It is very important to use tar's "p" option when extracting the Stage 3 tarball - it tells tar to preserve any permissions and ownership that exists within the archive. Without this option, your Funtoo Linux filesystem permissions will be incorrect.