Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 442930 - How to install Gentoo with a UEFI motherboard
Summary: How to install Gentoo with a UEFI motherboard
Alias: None
Product: [OLD] Docs on
Classification: Unclassified
Component: New Documentation (show other bugs)
Hardware: All Linux
: Normal normal with 1 vote (vote)
Assignee: Sven Vermeulen (RETIRED)
Depends on:
Reported: 2012-11-13 03:11 UTC by Sylvain Alain (RETIRED)
Modified: 2014-12-23 16:11 UTC (History)
4 users (show)

See Also:
Package list:
Runtime testing required: ---


Note You need to log in before you can comment on or make changes to this bug.
Description Sylvain Alain (RETIRED) gentoo-dev 2012-11-13 03:11:40 UTC
Hi, I would like to see a document that explain how to install Gentoo using a UEFI motherboard.

Also, it would be nice to see how to start a kernel using UEFI+Grub2 and also UEFI+Kernel stub.

Finally, it seems that we need to use efibootmgr too.

I'm actually learning how to do that, but I need help, because I can't test it right now on my current box.

Reproducible: Always
Comment 1 nm (RETIRED) gentoo-dev 2012-11-13 06:11:26 UTC
this is possibly a duplicate of bug #439276; see

basically, we need to add a whole bunch of updates for modern hardware, but as i haven't yet rebuilt my box with all that stuff, i don't have a clear idea how to proceed. we can't really do something about this until we know the right procedures.

note that grub2 and efibootmgr are not stable, so we cannot document anything in the handbook that is ~arch only. you'd need to talk to the arch teams to get those packages stabilized.
Comment 2 Pacho Ramos gentoo-dev 2012-12-28 16:49:35 UTC
(In reply to comment #1)
> note that grub2 and efibootmgr are not stable, so we cannot document
> anything in the handbook that is ~arch only. you'd need to talk to the arch
> teams to get those packages stabilized.

If I don't misremember, fedora is using grub-legacy+patches to get UEFI support, maybe they could be included in our old grub ebuilds :/
Comment 3 Sven Vermeulen (RETIRED) gentoo-dev 2013-12-18 10:30:36 UTC
As I don't have a UEFI capable laptop yet either, can you tell us what we really need to have documented right now?

The instructions on GPT partition layout have been added and improved; GRUB2 is now the recommended boot loader and a BIOS boot partition is taken up in the instructions as well.

It would be really helpful if a wiki page or other document could be created with the delta's that we can pick from. Keep in mind that we should focus on the essentials here, not on the 1001 possible setups and so on.
Comment 4 Chris Wood 2014-02-16 23:59:37 UTC
Having just gone through the pain of doing just this I was about to file my own report, but I am happy to add to this one.

It would be nice if some of the UEFI process was at least noted in the main guides.  For example noting the changes to the partition table you need to apply, and kernel config changes that will allow you do forget using GRUB, i.e. setting the command line to include root=PARTUUID=.... 

I found these two pages helpful, although I have 4 partitions but I could have got away with just the three as I have not got grub2 installed as it kept failing with a kernel panic, I am guessing my system might have an old version of EFI based booting, so does not support the manager side, and I did not need to put the kernel onto a usb stick to get things running.
Comment 5 Sven Vermeulen (RETIRED) gentoo-dev 2014-12-23 16:11:55 UTC
I updated the installation instructions to inform about EFI as well. Hopefully this makes for a good start, and additional suggestions can be made by other developers with more experience on it (I do use UEFI, but with gummiboot as boot loader instead of directly using the EFI variables to boot kernels).