libreboot / libreboot (public) (License: Unspecified) (since 2023-04-11) (hash sha1)
libreboot project provides free boot firmware based on coreboot
Date (UTC) User Event
2023-12-03 00:53 libreboot Reference refs/heads/master updated from cb3fad075984279063611423f49048c7733ec0af to 7af200a16aa2f8221f7b177add9cd7bfce39b4da
2023-12-02 18:44 libreboot Reference refs/heads/master updated from 5a6dec97339b02998a31577ebca23f607f5157f5 to cb3fad075984279063611423f49048c7733ec0af
2023-12-02 17:19 libreboot Reference refs/heads/master updated from 4e00ac003b37e6ad403f2271c821e3d81274395a to 5a6dec97339b02998a31577ebca23f607f5157f5
2023-11-22 12:26 libreboot Reference refs/heads/master updated from 83c8248f5595373e9bfd296c0ee4e03bfd93380f to 4e00ac003b37e6ad403f2271c821e3d81274395a
2023-11-15 17:51 libreboot Reference refs/heads/master updated from 39aad57873b9e6265d089ef7dbb4dc5add5c659f to 83c8248f5595373e9bfd296c0ee4e03bfd93380f
2023-11-13 23:02 libreboot Reference refs/heads/master updated from 47ef411efb6b669b7befd2a1cf22f999d4521999 to 39aad57873b9e6265d089ef7dbb4dc5add5c659f
2023-11-09 21:41 libreboot Reference refs/heads/master updated from ce1176f521705104ce11c3e322e11fcdb6e8561f to 47ef411efb6b669b7befd2a1cf22f999d4521999
2023-11-09 16:41 libreboot Reference refs/heads/master updated from 70882902b5d4f0bdc7a627b0bc9b6152bbecaca9 to ce1176f521705104ce11c3e322e11fcdb6e8561f
2023-11-09 16:35 libreboot Reference refs/heads/master updated from 5af3ae0586ba1f437cecab551ab4fba6fb6bdef1 to 70882902b5d4f0bdc7a627b0bc9b6152bbecaca9
2023-11-08 07:00 libreboot Reference refs/heads/hp8560w_wip deleted (was c69a37be2153afc6c6c1caecb1b7c490556e909f)
2023-11-08 07:00 libreboot Reference refs/heads/hp2170p_wip deleted (was cfaee843952fdc9f8ffce4f5f5437229589bbd5b)
2023-11-08 06:52 libreboot Reference refs/heads/8560W_DOES_NOT_BOOT_YET deleted (was 129caf109b20237687ccd083c300b62a4adf6362)
2023-11-08 06:52 libreboot Reference refs/heads/dell_e6400_wip deleted (was 92132e8e18a1f5d66591eb89691ede7e33efe3fe)
2023-11-08 06:51 libreboot Reference refs/heads/e6400nvidia_wip deleted (was 8e378ee4c058e89f70d4858405ae370ea2f36aa2)
2023-11-08 06:51 libreboot Reference refs/heads/hp8560w_wip_backup deleted (was 18e1c9a3542b1dc0ffb208555f6258717e8a6384)
2023-11-08 06:50 libreboot Reference refs/heads/mbair42_wip_2 deleted (was f0e5cf5dddd1fcd355ddf17060a0f1ad48e1cacf)
2023-11-08 06:50 libreboot Reference refs/heads/mbair42_wip deleted (was 65f5fde5c695828e77f1d90023ed3b835445e680)
2023-11-08 06:43 libreboot Reference refs/heads/wip_tianocore deleted (was 4a6d2d2b90eab28b87a383c390e184f2449ac590)
2023-11-08 06:43 libreboot Reference refs/heads/hp8560w_NOT_BOOTING_YET deleted (was c69a37be2153afc6c6c1caecb1b7c490556e909f)
2023-11-08 06:42 libreboot Reference refs/heads/blobutil_kbc1126_ec deleted (was b9ee4e79c33365ede01fb7d2a0d5c8f3c1a1928c)

README.md:

Libreboot

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

The libreboot project provides libre boot firmware that initializes the hardware (e.g. memory controller, CPU, peripherals) on specific Intel/AMD x86 and ARM targets, which then starts a bootloader for your operating system. Linux/BSD are well-supported. It replaces proprietary BIOS/UEFI firmware. Help is available via #libreboot IRC on Libera IRC.

Why use Libreboot?

Why should you use libreboot?

Libreboot gives you freedoms that you otherwise can't get with most other boot firmware. It's extremely powerful and configurable for many use cases.

You have rights. The right to privacy, freedom of thought, freedom of speech and the right to read. In this context, Libreboot gives you these rights. Your freedom matters. Right to repair matters. Many people use proprietary (non-libre) boot firmware, even if they use a libre OS. Proprietary firmware often contains backdoors (more info on the FAQ), and it and can be buggy. The libreboot project was founded in December 2013, with the express purpose of making coreboot firmware accessible for non-technical users.

The libreboot project uses coreboot for hardware initialisation. Coreboot is notoriously difficult to install for most non-technical users; it handles only basic initialization and jumps to a separate payload program (e.g. GRUB, Tianocore), which must also be configured. The libreboot software solves this problem; it is a coreboot distribution with an automated build system (named lbmk) that builds complete ROM images, for more robust installation. Documentation is provided.

How does Libreboot differ from coreboot?

In the same way that Debian is a GNU+Linux distribution, libreboot is a coreboot distribution. If you want to build a ROM image from scratch, you otherwise have to perform expert-level configuration of coreboot, GRUB and whatever other software you need, to prepare the ROM image. With libreboot, you can literally download from Git or a source archive, and run make, and it will build entire ROM images. An automated build system, named lbmk (Libreboot MaKe), builds these ROM images automatically, without any user input or intervention required. Configuration has already been performed in advance.

If you were to build regular coreboot, without using libreboot's automated build system, it would require a lot more intervention and decent technical knowledge to produce a working configuration.

Regular binary releases of libreboot provide these ROM images pre-compiled, and you can simply install them, with no special knowledge or skill except the ability to follow installation instructions and run commands BSD/Linux.

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 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.

How to help

You can check bugs listed on the bug tracker.

If you spot a bug and have a fix, the website has instructions for how to send patches, and you can also report it. Also, this entire website is written in Markdown and hosted in a separate repository where you can send patches.

Any and all development discussion and user support are all done on the IRC channel. More information is on https://libreboot.org/contact.html.

LICENSE FOR THIS README

It's just a README file. This README file is released under the terms of the Creative Commons Zero license, version 1.0 of the license, which you can read here:

<https://creativecommons.org/publicdomain/zero/1.0/legalcode.txt>

Hints:
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://rocketgit.com/user/libreboot/libreboot

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@ssh.rocketgit.com/user/libreboot/libreboot

Clone this repository using git:
git clone git://git.rocketgit.com/user/libreboot/libreboot

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a merge request:
... clone the repository ...
... make some changes and some commits ...
git push origin main