libreboot build system (LibreBoot-MaKe). Libreboot performs hardware initialization on your computer, using coreboot, to replace the proprietary BIOS/UEFI firmware on supported x86 computers.

Leah Rowe ca45a60ff2 bump grub revision to latest upstream 1 year ago
blobs 501745630b fix part 1 checksum in t440p gbe.bin 1 year ago
resources ca45a60ff2 bump grub revision to latest upstream 1 year ago
util 6c12afa996 util/nvmutil: more human-friendly exit messages 1 year ago
.gitcheck 3f12ef8530 bonerfix 1 year ago
.gitignore f5b4eb3f1e update gitignore 1 year ago
COPYING 89517ed6b9 libreboot! 2 years ago
Makefile 7af9953463 pragmatic system distribution guideline compliance 1 year ago
README.md 2589d367cc update the README 1 year ago
blobutil 7af9953463 pragmatic system distribution guideline compliance 1 year ago
build 0b3b7f93b7 added workaround for git credentials 2 years ago
download 7af9953463 pragmatic system distribution guideline compliance 1 year ago
modify c771aad44f add scripts for modifying coreboot configs 2 years ago
projectname 208a793107 update README 2 years ago
update 67e2365a6d also change the build and update scripts to env bash 2 years ago

README.md

Free your BIOS today! GNU GPL style

Find libreboot documentation at https://libreboot.org/

Libreboot is freedom-respecting boot firmware that initializes the hardware (e.g. memory controller, CPU, peripherals) in your computer so that software can run. Libreboot then starts a bootloader to load your operating system. It replaces the proprietary BIOS/UEFI firmware typically found on a computer. Libreboot is compatible with specific computer models that use the Intel/AMD x86 architecture. Libreboot works well with GNU+Linux and BSD operating systems. User support is available at #libreboot on Freenode IRC.

Libreboot is a Free Software project, but can be considered Open Source. The GNU website teaches why you should call it Free Software instead; alternatively, you may call it libre software.

Libreboot uses coreboot for hardware initialization. However, coreboot is notoriously difficult to compile and install for most non-technical users. There are many complicated configuration steps required, and coreboot by itself is useless; coreboot only handles basic hardware initialization, and then jumps to a separate payload program. The payload program can be anything, for example a Linux kernel, bootloader (such as GNU GRUB), UEFI implementation (such as Tianocore) or BIOS implementation (such as SeaBIOS). While not quite as complicated as building a GNU+Linux distribution from scratch, it may aswell be as far as most non-technical users are concerned.

Libreboot solves this problem in a novel way: Libreboot is a coreboot distribution much like Debian is a GNU+Linux distribution. Libreboot provides an automated build system that downloads, patches (where necessary) and compiles coreboot, GNU GRUB, various payloads and all other software components needed to build a complete, working ROM image that you can install to replace your current BIOS/UEFI firmware, much like a GNU+Linux distribution (e.g. Debian) provides an ISO image that you can use to replace your current operating system (e.g. Windows).

Information about who works on Libreboot, and who runs the project, can be found on the who page page.

Why use Libreboot?

Free software is important for the same reason that education is important. All children and adults alike should be entitled to a good education. Knowledge begs to be free! In the context of computing, this means that the source code should be fully available to study, and use in whatever way you see fit. In the context of computer hardware, this means that Right to Repair should be universal, with full access to documents such as the schematics and boardview files.

The four freedoms are paramount!

You have rights. The right to privacy, freedom of thought, freedom of speech and the right to read. In the context of computing, that means anyone can use free software. Simply speaking, free software is software that is under the direct sovereignty of the user and, more importantly, the collective that is the community. Libreboot is dedicated to the Free Software community, with the aim of making free software at a low level more accessible to non-technical people.

Many people use proprietary boot firmware, even if they use GNU+Linux. Non-free boot firmware often contains backdoors, can be slow and have severe bugs. Development and support can be abandoned at any time. By contrast, Libreboot is a free software project, where anyone can contribute or inspect its code.

Libreboot is faster, more secure and more reliable than most non-free firmware. Libreboot provides many advanced features, like encrypted /boot/, GPG signature checking before booting a Linux kernel and more! Libreboot gives you control over your computing.

Project goals

  • Support as much hardware as possible! Libreboot aims to eventually have maintainers for every board supported by coreboot, at every point in time.
  • Make coreboot easy to use. Coreboot is notoriously difficult to install, due to an overall lack of user-focused documentation and support. Most people will simply give up before attempting to install coreboot. Libreboot's automated build system and user-friendly installation instructions solves this problem.

Libreboot attempts to bridge this divide by providing a build system automating much of the coreboot image creation and customization. Secondly, the project produces documentation aimed at non-technical users. Thirdly, the project attempts to provide excellent user support via mailing lists and IRC.

Libreboot already comes with a payload (GRUB), flashrom and other needed parts. Everything is fully integrated, in a way where most of the complicated steps that are otherwise required, are instead done for the user in advance.

You can download ROM images for your libreboot system and install them without having to build anything from source. If, however, you are interested in building your own image, the build system makes it relatively easy to do so.

Not a coreboot fork!

Libreboot is not a fork of coreboot. Every so often, the project re-bases on the latest version of coreboot, with the number of custom patches in use minimized. Tested, stable (static) releases are then provided in Libreboot, based on specific coreboot revisions.

LICENSE FOR THIS README: GNU Free Documentation License 1.3 as published by the Free Software Foundation, with no invariant sections, no front cover texts and no back cover texts. If you wish it, you may use a later version of the GNU Free Documentation License as published by the Free Software Foundation.

Copy of the GNU Free Documentation License v1.3 here: https://www.gnu.org/licenses/fdl-1.3.en.html

Info about Free Software Foundation: https://www.fsf.org/