Test

Introduction

root # Welcome to Funtoo Linux!

Welcome to Funtoo Linux! This document was written to help you install Funtoo Linux on PC-compatible systems, while keeping distracting options regarding system configuration to a minimum.

If you're new to installing a Gentoo-based Linux, or new to Linux entirely -- welcome! We have attempted to make these installation instructions understandable to new users as well. We encourage all new users to read Wolf Pack Philosophy to understand some of the distinctives of the Funtoo community.

Before we get started, please review the following important information:

Our desktop environment stages (GNOME, Cinnamon, etc.) now support seamless installation on VMware Workstation Pro virtual machines. We highly recommend you enable 3D Accelerated Video for your VM, which is not enabled by default. Click here for more info.

Current Release

The current release of Funtoo Linux is next, sometimes referred to as next-release. This is actually a (mostly) rolling release with an emphasis on being current.

Development Model

Funtoo Linux is a community-developed Linux meta-distribution. If you use Funtoo Linux, you are welcome to contribute to its development via code.funtoo.org without going through any special procedure or complicated approval process. See Development Guide for more information on how to contribute to Funtoo. We also have YouTube video tutorials to help you get started.

Support Matrix

Please use our Support Matrix to familiarize yourself with the technologies we do -- and do not -- support.

Documentation Styles

We now offer the ability to read and browse the Install Guide section-by-section. Online users may find this more convenient.

Running Steam

We have recently released official Steam Docker Images as well as support for Steam on Flatpak -- these are the officially-supported way to run Steam on Funtoo. See Steam for more information.

Containers

LXD container management as well as Docker is officially supported. Please see Chroot and Containers for an incomplete but growing list of container technologies available, along with links to further documentation.

New Fchroot Tool

Our new fchroot tool is now available to allow you to run ARM and RISCV environments on PC-compatible hardware. This is a very effective tool for accelerating building of large pieces of software on resource-constrained ARM systems. See the code.funtoo.org page, Frankenchroot and Frankenchroot/Live_NFS_Frankenchroot for set-up information.

Now that we've covered all that important information, it's time to get started installing Funtoo Linux!

Installation Overview

This is a basic overview of the Funtoo installation process:

1. Get Acquainted with Funtoo's Culture and Support Matrix.
2. Download and boot the Funtoo LiveCD/LiveUSB.
3. Prepare your disk.
4. MBR Partitioning.
5. GPT Partitioning.
6. Create and mount filesystems.
7. Setting the Date.
8. Install the Funtoo stage tarball of your choice.
9. Chroot into your new system.
10. Download the Portage tree.
11. Configure your system.
12. Introducing Portage.
13. Install a kernel.
14. Install a bootloader.
15. Configure the Network.
16. Complete final steps.
17. Profile Configuration.
18. All Done! Enjoy!