The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.
Emerge
Getting started with emerge
Emerge is the front-end for funtoo's Portage package manager. With emerge it is easy to install, update or remove packages.
Update Package Database
Sync local package database. This will update your local Portage tree with the latest Funtoo ebuilds.
root # emerge --sync
Search packages
Search packages by name.
root # emerge -s firefox root # emerge --search firefox
Search packages by description.
root # emerge -S web browser root # emerge --searchdesc web browser
Install packages
Install package.
root # emerge firefox
Install multiple packages.
root # emerge firefox thunderbird
Install package. Ask for confirmation before performing any changes. Show verbose output.
root # emerge -av firefox root # emerge --ask firefox
Remove packages
Remove package.
root # emerge -C firefox root # emerge --unmerge firefox
Remove package. Ask for confirmation before performing any changes.
root # emerge -aC firefox
Remove orphaned packages. Ask for confirmation before performing any changes.
root # emerge -a --depclean
Update packages
Update all packages.
root # emerge -uDN @world
Update all packages. Ask for confirmation before performing any changes. Show verbose output.
root # emerge -uavDN @world
When upgrading to a new version of perl, it is necessary to also run perl-cleaner afterwards:
root # emerge -auvDN @world root # perl-cleaner --all
This requirement of running perl-cleaner will eventually go away, once all perl-related ebuilds are updated to EAPI 5. EAPI 5 is a version of the Ebuild specification that supports smart updating of perl-related bits.