Install/Introduction

Install Guide: 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 1.4, sometimes referred to as 1.4-release or 1.4-release-std. This is actually a (mostly) rolling release with an emphasis on stability. We also have next available, which is a rolling release with updated core packages and is the default for Raspberry Pi 4 and the SiFive U740 RISC-V stages.

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 also offer the ability to view the install instructions as a single page, suitable for printing.

Release Notes

To familiarize yourself with the latest changes in Funtoo Linux, Release Notes for Funtoo Linux 1.4 are available.

Upgrade Instructions

If upgrading from Funtoo Linux 1.3 or earlier, please consult Funtoo Linux 1.4 Upgrade Instructions.

AWS and Docker Images

We now offer direct deployment of Docker images as well as Funtoo Linux in Amazon Web Services. This is a useful option for those who wish to take advantage of AWS or deploy Funtoo Linux automatically. A tutorial-style guide on how to use AWS with Funtoo is available.

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!

Install Guide, Chapter 0

Next >