Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

<div lang="en" dir="ltr" class="mw-content-ltr">
<includeonly>
== Download and Extract Stage3 ==
</includeonly><noinclude><languages/>
= Install Guide: Download and Extract Stage3 =
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{{InstallNavigation|num=8|prev=Setting the Date|next=Chroot}}</noinclude>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
To download the correct build of Funtoo Linux for your system, first familiarize yourself with the [[Support Matrix]], in particular the [[Support Matrix#Desktop Environments|Desktop Environments]] section, to help you make a decision about which desktop environment to set up (we recommend GNOME for new users.) Then, 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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== What Subarch? ====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
From the subarch list at [[Subarches]], choose your desired level of optimization. A system built specifically for your CPU will run faster than a less-optimized system. For a modern Intel or AMD system, it is safe to pick the exact optimization level for your particular family of CPU. This will offer the best possible performance.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If you are using a virtualization technology to run Funtoo Linux and your VM may be used on 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 more generic image if it may run on both AMD and Intel processors.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Once you have found the appropriate subarch at [[Subarches]], you will likely have a few installation images to choose from. This next section will help you understand which one to pick.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== Which Image? ====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{{VMwareBlurb}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can always manually choose an installation image via [https://build.funtoo.org https://build.funtoo.org] as well as using the [[Subarches]] page. Here is some guidance on choosing the best {{c|.tar.xz}} image for download. When choosing an image:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
;''Pick {{c|next}}.'': This is next release of Funtoo Linux, our current release.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
;''Pick the subarch for the CPU family of the system you are installing on.'': This will provide the best performance.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
;Choose ''{{c|stage3}}'' for...: The ''{{c|stage3}}'' is a more traditional, minimal and non-graphical installation of Funtoo. You will then build your system up to your desired state using {{c|emerge}}.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
;Choose ''{{c|gnome}}'' for...: The ''{{c|gnome}}'' installation image, if available, includes the full GNOME environment as well as Firefox already optimized for your hardware. You can then continue to further customize your system after installation. See the [[Support Matrix#Desktop Environments|Desktop Environments]] section of our [[Support Matrix]] for more desktop options.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
;The ''{{c|lxd}}'' image for...: The ''{{c|lxd}}'' image is for use with [[LXD]], and is not used for installing directly on a desktop or laptop, so you should not select this option for regular installs. To install, first download and then {{c|lxc image import <name>.tar.xz --alias funtoo}} and then you can {{c|lxc  launch funtoo my_container}}.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== Download the Stage3 ====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Once you have found the stage3 that you would like to download, use {{c|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 {{f|/mnt/funtoo}} directory as follows:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{{Note|If you are using the Funtoo LiveCD, you can use a text-based browser to download your preferred stage. Type {{c|links https://build.funtoo.org}} rather than the {{c|wget}} command below. Hit enter to select the appropriate directories and stage3.}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{{console|body=
###i## cd /mnt/funtoo
###i## wget https://build.funtoo.org/next/x86-64bit/generic_64/stage3-latest.tar.xz
}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== Verify downloaded tarball ====
Funtoo Linux stage tarballs are signed using GPG by the build server they are built on. It's a good practice to verify [https://en.wikipedia.org/wiki/Digital_signature#Applications authenticity and integrity] of downloaded files when possible. For instructions how to import and trust GPG keys check [[GPG_Signatures|our wiki page about GPG signatures]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Then, you can download the stage3's GPG signature and use the {{c|gpg --verify}} command in order to verify your tarball:
{{console|body=
###i## wget https://build.funtoo.org/next/x86-64bit/generic_64/stage3-latest.tar.xz.gpg
###i## gpg --verify stage3-latest.tar.xz.gpg stage3-latest.tar.xz
}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Once the stage is downloaded and verified, extract the contents with the following command, substituting in the actual name of your Stage 3 tarball:
{{console|body=
###i## tar --numeric-owner --xattrs --xattrs-include='*' -xpf stage3-latest.tar.xz
}}
{{Important|It is very important to use all the options included above. See below for details.}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Here are what the options to {{c|tar}} do:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
;{{c|--numeric-owner}}: Without this option, {{c|tar}} will map ownership and group ownership based on the UID to user and GID to group mappings as defined on the LiveCD. We don't want this -- we want the ''numeric values'' of the UIDs and GIDs in the tarball to be preserved on disk, so when your Funtoo Linux system boots, the UIDs and GIDs are set correctly for Funtoo. That is what this option tells {{c|tar}} to do.
;{{c|1=--xattrs --xattrs-include='*'}}: Funtoo Linux uses filesystem extended attributes to set Linux capabilities, which allow for certain programs such as {{c|ping}} to have enhanced privileges without having to be fully 'suid root'. Even with the {{c|-p}} option, {{c|tar}} will not restore extended attributes we need unless these two options are specified.
;{{c|-xpf}}: This instructs {{c|tar}} to extract ({{c|x}}), preserve regular permissions and ownership ({{c|p}}), and use the filename ({{c|f}}) specified.
<noinclude>{{InstallNavigation|num=8|prev=Setting the Date|next=Chroot|align=right}}</noinclude>
</div>

Export translations

Navigation menu

Search