The rEFInd Boot Manager: Getting rEFInd

# The rEFInd Boot Manager:
Getting rEFInd

by Roderick W. Smith, rodsmith@rodsbooks.com

Originally written: 3/14/2012; last Web page update: 11/12/2018, referencing rEFInd 0.11.4

This Web page is provided free of charge and with no annoying outside ads; however, I did take time to prepare it, and Web hosting does cost money. If you find this Web page useful, please consider making a small donation to help keep this site up and running. Thanks!

Donate $1.00 | Donate $2.50 | Donate $5.00 | Donate $10.00 | Donate $20.00 | Donate another value

This page is part of the documentation for the rEFInd boot manager. If a Web search has brought you here, you may want to start at the main page.

Note: I consider rEFInd to be beta-quality software! I'm discovering bugs (old and new) and fixing them every few days. That said, rEFInd is a usable program in its current form on many systems. If you have problems, feel free to drop me a line.

## Getting rEFInd from Sourceforge

You can find the rEFInd source code and binary packages at its SourceForge page. Note that rEFInd is OS-independent—it runs before the OS, so you download the same binary package for any OS. You can obtain rEFInd in several different forms:

- A binary zip file—Download this if you want to install rEFInd and/or its filesystem drivers on an x86, x86-64, or ARM64 computer and have no need to test rEFInd first by booting it on an optical disc. This zip file package includes x86 (aka IA32), x86-64 (aka x64, AMD64, or EM64T), and ARM64 (aka AARCH64 or AA64) versions of rEFInd. Which you install depends on your architecture, as described on the Installing rEFInd page. Some users of Arch Linux have reported problems booting some specific Arch Linux kernels with rEFInd and some other tools. For them, a variant package exists in which the x86-64 binary was compiled with GNU-EFI rather than the usual TianoCore EDK2. This change helps some users with this problem.
- A binary RPM file—If you use an RPM-based x86-64 Linux system such as Fedora or openSUSE, you can install the binary RPM package rather than use the binary zip file. (I don't provide equivalent 32-bit [x86] or ARM64 packages.) This package runs the `refind-install` script (described on the Installing rEFInd page) as part of the installation process. Distribution maintainers can examine the `refind.spec` file in the source package and tweak it to their needs. The source RPM file might or might not build on your system as-is; it relies on assumptions about the locations of the GNU-EFI development files.
- A binary Debian package—If you use an x86-64 version of Debian, Ubuntu, Mint, or another Debian-based distribution, you can install from this package, which was converted from the binary RPM package using `alien`. Note that an Ubuntu PPA is available, which may install more smoothly and will cause rEFInd to automatically update with other packages.
- A CD-R image file—This download contains the same files as the binary zip file, but you can burn it to a CD-R to test rEFInd (and its filesystem drivers) without installing it first. (It boots on UEFI PCs, but fails on some older Macs.) If you like it, you can then copy the files from the CD-R to your hard disk. The files are named in such a way that the disc should boot on either 64-bit (x86-64) or 32-bit (x86) EFI computers. I've included an open source EFI shell program on this disc that's not included in the binary zip file, so that you can access an EFI shell from a bootable disc even if you don't have an EFI shell available from your regular hard disk. This can be an extremely valuable diagnostic tool if you know how to use an EFI shell.
- A USB flash drive image file—Although you can create your own rEFInd USB flash drive, you may find it easier to download this version and copy it to your USB drive with `dd` or some other low-level disk copying utility.
- A source code tarball—This is useful if you want to compile the software locally. Note that I use Linux with the TianoCore EFI Development Kit 2 (EDK2) to build my binary packages (above), although the GNU-EFI development tools are also supported, and are used in building the Ubuntu PPA.
- Source code via git—If you want to peruse the source code in your Web browser or get the very latest version (including pre-release bug fixes and updates), you can use the GitHub git repository. This access method is most useful to programmers, or at least to those who are familiar with programming tools. If you need to ask "what's git?", this is probably not the best way for you to obtain rEFInd.

If you're using a platform other than x86 or x86-64, you can give rEFInd a try; however, you'll need to build it from source code yourself or track down a binary from another source. (Perhaps by the time you read this it will be included in Linux distributions built for unusual CPUs.)

To extract the files from the zip file images I've provided, you'll need a tool such as `unzip`, which is included with Linux and Mac OS X. Numerous Windows utilities also support this format, such as PKZIP and 7-Zip. The source files come in tarball format, for which a tool such as the Unix/Linux `tar` utility is appropriate.

You should be able to create a bootable USB flash drive from either the binary zip file or the CD-R image file; just treat the flash drive as if it were a hard disk and install rEFInd as described on the installation page. Using the fallback boot loader name of `EFI/boot/bootx64.efi` is likely to be the most useful way to install rEFInd to a removable medium.

## Getting rEFInd from Your OS's Repositories

I know of a small number of pre-packaged versions of rEFInd, either in official OS repositories or in ancillary repositories:

- Debian—Debian added rEFInd 0.10.3 to its "sid" (unstable") repository in June of 2016. Because most people don't use this "bleeding-edge" version of the distribution, it is not yet a practical option for most users; but it is on the way. You can download and install it as a separate package here. Debian's inclusion of rEFInd means that derivative distributions, such as Ubuntu and Mint, will eventually receive rEFInd packages, too. Be aware that Debian's package is not signed with a Secure Boot key, although if the `sbsigntool` package is installed, the installation scripts will generate and use their own Secure Boot keys and sign the binary with them.
- Ubuntu—Two Ubuntu-specific methods of installing rEFInd in this distribution exist:
  - Ubuntu 17.04 ("Zesty Zapus") includes rEFInd 0.10.4. Note that, like the Debian package, this one is not signed for use with Secure Boot, but if your system includes the `sbsigntool` package, the installer will generate a local key for this purpose. If you want a more recent version, you can use my PPA or install my Debian package.
  - I've created a rEFInd PPA for Ubuntu. To use it, open a Terminal window and type the following commands:

      $ sudo apt-add-repository ppa:rodsmith/refind
      $ sudo apt-get update
      $ sudo apt-get install refind

  You'll be asked whether to install rEFInd to the ESP when you first install it. Thereafter, the rEFInd version will update along with your other software. This package is built with GNU-EFI and is not signed with a Secure Boot key; however, the install script should sign the binary with a locally-generated key if it detects that your system uses Secure Boot. Thus, if you've previously installed one of my binaries on a Secure Boot system and added its key as a MOK, you'll have to add your local key when you reboot.

- Arch Linux—You can obtain rEFInd from the Arch repositories, in both a stable version (the `refind-efi` package installable via `pacman`) and an experimental release built from rEFInd's git repository in the Arch User Repository (AUR), under the name `refind-efi-git`. The git release is likely to include pre-release bug fixes and new features, but those features may be poorly tested or undocumented.
- ALT Linux—This RPM-based distribution uses rEFInd by default on EFI-based computers. If I understand correctly, ALT's optical disc installer boots with a combination of rEFInd and ELILO. The distribution provides an RPM of rEFInd; see this page for details.
- Gentoo Linux—An official ebuild of rEFInd is available; see here for details and here for Gentoo's official rEFInd documentation. Because Gentoo packages are compiled locally, there is no version that's pre-signed with Secure Boot keys; but as with any rEFInd binary, you can sign it yourself, and the installer script should do so automatically if `sbsign` is available.
- Slackware—As far as I know, an official rEFInd package is not available as part of Slackware; however, a Slackware package from SlackBuilds is available.
- Fat Dog—This variant of Puppy Linux uses a combination of rEFInd and GRUB 2 to boot its installation medium in EFI mode and provides a rEFInd package in its repository set.
- The Nix Packages collection—This site creates packages for a number of OSes using its own packaging system.

If you hear of rEFInd being included in another OS's official package set, feel free to drop me a line.

copyright © 2012–2018 by Roderick W. Smith

This document is licensed under the terms of the GNU Free Documentation License (FDL), version 1.3.

If you have problems with or comments about this Web page, please e-mail me at rodsmith@rodsbooks.com. Thanks.

Go to the main rEFInd page

Learn how to install rEFInd

Return to my main Web page.