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've had previous experience installing Gentoo Linux then a lot of steps will be familiar, but you should still read through as there are a few differences. 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.
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
- 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.
- 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.
- 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!
This is a basic overview of the Funtoo installation process:
- Download and boot the live CD of your choice.
- Prepare your disk.
- MBR Partitioning.
- GPT Partitioning.
- Create and mount filesystems.
- Setting the Date.
- Install the Funtoo stage tarball of your choice.
- Chroot into your new system.
- Download the Portage tree.
- Configure your system.
- Introducing Portage.
- Install a kernel.
- Install a bootloader.
- Configure the Network.
- Complete final steps.
- Profile Configuration.
- All Done! Enjoy!
|Install Guide, Chapter 0 ||Next > |