Documentation – Gentoo Linux

<!DOCTYPE html> <html lang="en-US" dir="ltr"> <head> <meta charset="utf-8"> <title>Documentation – Gentoo Linux</title> <meta name="theme-color" content="#54487a"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta property="og:title" content="Documentation – Gentoo Linux"> <meta property="og:image" content="https://www.gentoo.org/assets/img/og-image.jpg"> <meta property="og:description" content="News and information from Gentoo Linux"> <meta name="twitter:image" content="https://www.gentoo.org/assets/img/logo/gentoo-g.png"> <link rel="apple-touch-icon" href="https://www.gentoo.org/assets/img/logo/icon-192.png"> <link rel="icon" sizes="192x192" href="https://www.gentoo.org/assets/img/logo/icon-192.png"> <link href="https://assets.gentoo.org/tyrian/v1/bootstrap.min.css" rel="stylesheet" media="screen"> <link href="https://assets.gentoo.org/tyrian/v1/tyrian.min.css" rel="stylesheet" media="screen"> <link href="/assets/css/screen.css" rel="stylesheet" media="screen"> <link rel="icon" href="/favicon.ico" type="image/x-icon"> <link rel="search" type="application/opensearchdescription+xml" href="https://www.gentoo.org/search/www-gentoo-org.xml" title="Gentoo Website"> <link rel="search" type="application/opensearchdescription+xml" href="https://www.gentoo.org/search/forums-gentoo-org.xml" title="Gentoo Forums"> <link rel="search" type="application/opensearchdescription+xml" href="https://www.gentoo.org/search/bugs-gentoo-org.xml" title="Gentoo Bugzilla"> <link rel="search" type="application/opensearchdescription+xml" href="https://www.gentoo.org/search/packages-gentoo-org.xml" title="Gentoo Packages"> <link rel="search" type="application/opensearchdescription+xml" href="https://www.gentoo.org/search/archives-gentoo-org.xml" title="Gentoo List Archives"> </head> <body class=""> <header> <div class="site-title"> <div class="container"> <div class="row"> <div class="site-title-buttons"> <div class="btn-group btn-group-sm"> <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a> <div class="btn-group btn-group-sm"> <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#"> <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span> </a> <ul class="dropdown-menu dropdown-menu-right"> <li><a href="https://www.gentoo.org/" title="Gentoo's main website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li> <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li> <li><a href="https://bugs.gentoo.org/" title="Discover and report issues with Gentoo"><span class="fa fa-bug fa-fw"></span> Bugs</a></li> <li><a href="https://packages.gentoo.org/" title="Find software to install"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li> <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li> <li class="divider"></li> <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the dev community"><span class="fa fa-rss fa-fw"></span> Planet</a></li> <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li> <li><a href="https://devmanual.gentoo.org/" title="Read the development guide"><span class="fa fa-book fa-fw"></span> Devmanual</a></li> <li><a href="https://gitweb.gentoo.org/" title="Browse our source code in Gitweb"><span class="fa fa-code fa-fw"></span> Gitweb</a></li> <li class="divider"></li> <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by the Gentoo infra team"><span class="fa fa-server fa-fw"></span> Infra status</a></li> </ul> </div> </div> </div> <div class="logo"> <a href="/" title="Back to the homepage" class="site-logo"> <img src="https://assets.gentoo.org/tyrian/v1/site-logo.png" alt="Gentoo Linux logo" srcset="https://assets.gentoo.org/tyrian/v1/site-logo.svg"> </a> </div> </div> </div> </div> <nav class="tyrian-navbar" role="navigation"> <div class="container"> <div class="row"> <div class="navbar-header"> <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse"> <span class="sr-only">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> </div> <div class="collapse navbar-collapse navbar-main-collapse"> <ul class="nav navbar-nav"> <li class=""><a href="/">Home</a></li> <li class=""><a href="/get-started/">Get started</a></li> <li class=""><a href="/downloads/">Downloads</a></li> <li class=""><a href="/inside-gentoo/">Inside Gentoo</a></li> <li class="active"><a href="/support/">Support</a></li> <li class=""><a href="/get-involved/">Get involved</a></li> </ul> <ul class="nav navbar-nav navbar-right"> <li class=""><a href="/donate/"><span class="fa fa-heart" style="color:#d9534f;"></span> Donate</a></li> </ul> </div> </div> </div> </nav> <nav class="navbar navbar-grey navbar-stick" role="navigation"> <div class="container"> <div class="row"> <div class="navbar-header"> <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-secondary-collapse"> <span class="sr-only">Toggle secondary navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> </div> <div class="collapse navbar-collapse navbar-secondary-collapse"> <ul class="nav navbar-nav"> <li class=""><a href="/support/consulting/">Consulting</a></li> <li class="active"><a href="/support/documentation/">Documentation</a></li> <li class=""><a href="https://packages.gentoo.org/">Package database <span class="fa fa-fw fa-external-link-square external-link" title="This link will leave www.gentoo.org."></span></a></li> <li class=""><a href="/support/news-items/">Repository news items</a></li> <li class=""><a href="/support/security/">Security</a></li> <li class=""><a href="/support/use-flags/">USE flags</a></li> <li class=""><a href="/support/rsync-mirrors/">rsync mirrors</a></li> </ul> </div> </div> </div> </nav> </header> <div class="container"> <div class="row"> <div id="content" class="col-md-12"> <h1 class="first-header">Documentation</h1> <div class="alert alert-info"> <strong>Looking for the Gentoo Handbook?</strong> <br> <a href="https://wiki.gentoo.org/wiki/Handbook:Main_Page" class="btn btn-info pull-right"> <span class="fa fa-fw fa-book"></span> Gentoo Handbook </a> <p> The Gentoo Handbook describes the installation process of a new Gentoo system in detail. Click the button on the right... </p> </div> <div class="row"> <div class="col-xs-12 col-md-8 col-md-offset-2"> <div class="panel panel-default"> <div class="panel-heading"> <h3 class="panel-title">Finding documentation on the <a href="//wiki.gentoo.org">Gentoo wiki</a></h3> </div> <div class="panel-body"> If you know what you are looking for, you can simply search for one or more keywords: <br><br> <form method="get" action="//wiki.gentoo.org/index.php?title=Special:Search"> <div class="input-group input-group-lg"> <input type="text" class="form-control" placeholder="Search on wiki.gentoo.org" name="search"> <span class="input-group-btn"> <button class="btn btn-default" type="submit"><span class="fa fa-fw fa-search"></span></button> </span> </div> </form> <br> Or, browse the wiki contents using these categories: <br><br> <div class="list-group" style="font-size: 125%;"> <a href="//wiki.gentoo.org/wiki/Category:Core_system" title="Category:Core system" class="list-group-item"><i class="fa fa-fw fa-terminal"></i> Core system</a> <a href="//wiki.gentoo.org/wiki/Category:Software" title="Category:Software" class="list-group-item"><i class="fa fa-fw fa-floppy-o"></i> Software</a> <a href="//wiki.gentoo.org/wiki/Category:Hardware" title="Category:Hardware" class="list-group-item"><i class="fa fa-fw fa-print"></i> Hardware</a> <a href="//wiki.gentoo.org/wiki/Category:Desktop" title="Category:Desktop" class="list-group-item"><i class="fa fa-fw fa-desktop"></i> Desktop</a> <a href="//wiki.gentoo.org/wiki/Category:Server_and_Security" title="Category:Server and Security" class="list-group-item"><i class="fa fa-fw fa-database"></i> Server and security</a> <a href="//wiki.gentoo.org/wiki/Category:Project_and_Community" title="Category:Project and Community" class="list-group-item"><i class="fa fa-fw fa-institution"></i> Project and community</a> </div> </div> </div> </div> </div> <h2>Developer documentation</h2> <p> In addition to the documentation available on the wiki, we also offer documentation resources geared towards Gentoo development: </p> <ul> <li><a href="https://devmanual.gentoo.org/">Gentoo Development Guide</a> (a.k.a Devmanual).</li> <li><a href="https://devmanual.gentoo.org/eclass-reference/index.html">Online eclass reference</a>.</li> </ul> </div> </div> </div> <footer> <div class="container"> <div class="row"> <div class="col-xs-12 col-md-offset-2 col-md-7"> </div> <div class="col-xs-12 col-md-3"> <h3 class="footerhead">Questions or comments?</h3> Please feel free to <a href="/inside-gentoo/contact/">contact us</a>. </div> </div> </div> <div class="container-sitemap"> <div class="container"> <div class="row row-sitemap hidden-sm hidden-xs"> <div class="col-xs-12 col-sm-4 col-md-2"> <h3 class="footerhead"><a href="/">Home</a></h3> <ul class="sitemap"> <li class=""><a href="/news/">News</a></li> </ul> </div> <div class="col-xs-12 col-sm-4 col-md-2"> <h3 class="footerhead"><a href="/get-started/">Get Started</a></h3> <ul class="sitemap"> <li class=""><a href="/get-started/about/">About Gentoo</a></li> <li class=""><a href="/get-started/philosophy/">Philosophy</a></li> <li class=""><a href="/get-started/screenshots/">Screenshots</a></li> <li class=""><a href="https://wiki.gentoo.org/wiki/FAQ">FAQ <span class="fa fa-fw fa-external-link-square external-link" title="This link will leave www.gentoo.org."></span></a></li> </ul> </div> <div class="col-xs-12 col-sm-4 col-md-2"> <h3 class="footerhead"><a href="/downloads/">Downloads</a></h3> <ul class="sitemap"> <li class=""><a href="/downloads/mirrors/">Mirrors</a></li> <li class=""><a href="/downloads/signatures/">Signatures</a></li> </ul> </div> <div class="col-xs-12 col-sm-4 col-md-2"> <h3 class="footerhead"><a href="/inside-gentoo/">Inside Gentoo</a></h3> <ul class="sitemap"> <li class=""><a href="/inside-gentoo/developers/">Developers</a></li> <li class=""><a href="https://wiki.gentoo.org/wiki/Project:Gentoo">Projects <span class="fa fa-fw fa-external-link-square external-link" title="This link will leave www.gentoo.org."></span></a></li> <li class=""><a href="/glep/">GLEPs</a></li> <li class=""><a href="/inside-gentoo/artwork/">Artwork</a></li> <li class=""><a href="/inside-gentoo/foundation/">Gentoo Foundation</a></li> <li class=""><a href="/inside-gentoo/sponsors/">Sponsors</a></li> <li class=""><a href="/inside-gentoo/stores/">Stores</a></li> <li class=""><a href="/inside-gentoo/contact/">Contact</a></li> </ul> </div> <div class="col-xs-12 col-sm-4 col-md-2"> <h3 class="footerhead"><a href="/support/">Support</a></h3> <ul class="sitemap"> <li class=""><a href="/support/consulting/">Consulting</a></li> <li class=""><a href="/support/documentation/">Documentation</a></li> <li class=""><a href="https://packages.gentoo.org/">Package database <span class="fa fa-fw fa-external-link-square external-link" title="This link will leave www.gentoo.org."></span></a></li> <li class=""><a href="/support/news-items/">Repository news items</a></li> <li class=""><a href="/support/security/">Security</a></li> <li class=""><a href="/support/use-flags/">USE flags</a></li> <li class=""><a href="/support/rsync-mirrors/">rsync mirrors</a></li> </ul> </div> <div class="col-xs-12 col-sm-4 col-md-2"> <h3 class="footerhead"><a href="/get-involved/">Get Involved</a></h3> <ul class="sitemap"> <li class=""><a href="/get-involved/irc-channels/">IRC channels</a></li> <li class=""><a href="https://forums.gentoo.org/">Forums <span class="fa fa-fw fa-external-link-square external-link" title="This link will leave www.gentoo.org."></span></a></li> <li class=""><a href="/get-involved/mailing-lists/">Mailing lists</a></li> <li class=""><a href="/get-involved/contribute/">Contribute</a></li> <li class=""><a href="/get-involved/become-developer/">Become a developer</a></li> <li class=""><a href="/get-involved/get-code/">Get the code</a></li> </ul> </div> </div> </div> </div> <div class="container"> <div class="row"> <div class="col-xs-3 col-md-2"> <ul class="footerlinks three-icons"> <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li> <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> </ul> <div> <div class="sitemap text-center"> <a href="https://wiki.gentoo.org/wiki/Foundation:Privacy_Policy">Privacy Policy</a> </div> </div> </div> <div class="col-xs-8 col-md-8"> <strong>© 2001-2025 Gentoo Authors</strong><br> <small> Gentoo is a trademark of the Gentoo Foundation, Inc. and of Förderverein Gentoo e.V. The contents of this document, unless otherwise expressly stated, are licensed under the <a href="https://creativecommons.org/licenses/by-sa/4.0/" rel="license">CC-BY-SA-4.0</a> license. The <a href="/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply. </small> </div> <div class="col-xs-1 col-md-1"> <strong class="text-dark">Version</strong><br /> <small> <a class="text-dark" href="https://gitweb.gentoo.org/sites/www.git/commit/?id=5a7c833 ">5a7c833 </a> </small> <strong class="text-dark">Generated</strong><br /> <small> <span class="text-dark">Generated: 2025-02-26T05:45:23Z</span> </small> </div> </div> </div> </footer> <script src="https://assets.gentoo.org/tyrian/v1/jquery.min.js"></script> <script src="https://assets.gentoo.org/tyrian/v1/bootstrap.min.js"></script> </body> </html>

CINXE.COM

Documentation – Gentoo Linux