2021-05-18 12:21:48 +00:00
|
|
|
---
|
2022-11-15 20:37:18 +00:00
|
|
|
title: Libreboot project
|
2022-11-13 21:12:15 +00:00
|
|
|
x-toc-enable: true
|
2021-05-18 12:21:48 +00:00
|
|
|
...
|
|
|
|
|
2023-04-24 11:59:01 +00:00
|
|
|
The *Libreboot* project provides
|
2023-11-07 13:14:50 +00:00
|
|
|
[free, open source](https://writefreesoftware.org/) (*libre*) boot
|
2023-07-06 12:22:11 +00:00
|
|
|
firmware based on coreboot, replacing proprietary BIOS/UEFI firmware
|
|
|
|
on [specific Intel/AMD x86 and ARM based motherboards](docs/hardware/),
|
|
|
|
including laptop and desktop computers. It initialises the hardware (e.g. memory
|
2023-07-06 12:13:58 +00:00
|
|
|
controller, CPU, peripherals) and starts a bootloader for your operating
|
|
|
|
system. [Linux](docs/linux/) and [BSD](docs/bsd/) are well-supported. Help is
|
|
|
|
available via [\#libreboot](https://web.libera.chat/#libreboot)
|
2023-12-25 08:21:37 +00:00
|
|
|
on [Libera](https://libera.chat/) IRC. The [tasks page](tasks/) lists what
|
2023-12-26 11:41:52 +00:00
|
|
|
we are working on (contributions are welcome, if you want to work on some of
|
|
|
|
them yourself).
|
2021-08-30 07:14:05 +00:00
|
|
|
|
2023-04-24 02:04:18 +00:00
|
|
|
<img tabindex=1 class="r" src="https://av.libreboot.org/hp9470m/9470m+2560p.jpg" /><span class="f"><img src="https://av.libreboot.org/hp9470m/9470m+2560p.jpg" /></span>
|
|
|
|
|
2024-02-20 08:24:14 +00:00
|
|
|
You can also [buy Libreboot preinstalled](https://minifree.org/) from Minifree Ltd,
|
2024-02-20 08:21:31 +00:00
|
|
|
on select hardware, aswell as send your compatible hardware
|
|
|
|
for [Libreboot preinstallation](https://minifree.org/product/installation-service/).
|
|
|
|
The founder and lead developer of Libreboot, Leah Rowe, also owns and operates
|
|
|
|
Minifree; sales provide funding for Libreboot.
|
|
|
|
|
2024-06-12 07:40:32 +00:00
|
|
|
**NEW RELEASE: The latest release is Libreboot 20240612, released on
|
|
|
|
6 June 2024.
|
|
|
|
See: [Libreboot 20240612 release announcement](news/libreboot20240612.md).**
|
2022-12-14 19:09:03 +00:00
|
|
|
|
2023-07-19 07:12:14 +00:00
|
|
|
*We* believe the freedom to [study, share, modify and use
|
|
|
|
software](https://writefreesoftware.org/), without any
|
|
|
|
restriction, is one of the fundamental human rights that everyone must have.
|
|
|
|
In this context, *software freedom* matters. Your freedom matters. Education
|
|
|
|
matters.
|
2023-11-03 15:26:10 +00:00
|
|
|
[Right to repair](https://yewtu.be/watch?v=Npd_xDuNi9k) matters; Libreboot lets
|
|
|
|
you continue to use your hardware, with continued firmware updates. All of this
|
2023-11-03 13:30:35 +00:00
|
|
|
is *why* Libreboot exists.
|
|
|
|
|
2023-11-03 13:38:53 +00:00
|
|
|
Overview of Libreboot design
|
|
|
|
============================
|
|
|
|
|
2023-11-03 13:58:39 +00:00
|
|
|
<img tabindex=1 class="l" style="max-width:25%;" src="https://av.libreboot.org/thinkpadcollection/thinkpadcollection1-min.jpg" /><span class="f"><img src="https://av.libreboot.org/thinkpadcollection/thinkpadcollection1-min.jpg" /></span>
|
|
|
|
|
2023-11-03 13:38:53 +00:00
|
|
|
Libreboot provides [coreboot](https://coreboot.org/) for [machine
|
|
|
|
initialisation](https://doc.coreboot.org/getting_started/architecture.html),
|
|
|
|
which then jumps to a [payload](https://doc.coreboot.org/payloads.html) in
|
|
|
|
the boot flash; coreboot works with many programs, but Libreboot specifically
|
|
|
|
provides SeaBIOS, GNU GRUB and U-Boot as options. Memtest86+ is also provided
|
|
|
|
in flash, on some mainboards. The payload is the program in flash that provides
|
|
|
|
the early user interface, for booting an operating system. This *payload*
|
|
|
|
infrastructure means you can run whatever you want (even Linux!) from the
|
|
|
|
boot flash.
|
|
|
|
|
|
|
|
Libreboot is specifically a *coreboot distribution*, in the same way that
|
2023-11-24 06:31:00 +00:00
|
|
|
Debian is a *Linux distribution*. Libreboot makes coreboot easy to use for
|
2023-11-03 13:38:53 +00:00
|
|
|
non-technical users, by providing a [fully automated build
|
|
|
|
system](docs/maintain/), [automated build process](docs/build/) and
|
|
|
|
[user-friendly installation instructions](docs/install/), in addition to
|
|
|
|
regular binary releases that provide pre-compiled ROM images for installation
|
|
|
|
on supported hardware. Without automation such as that provided by Libreboot,
|
|
|
|
coreboot would be inaccessible for most users; you can also
|
|
|
|
still [reconfigure](docs/maintain/) Libreboot however you wish.
|
|
|
|
|
2023-11-03 13:30:35 +00:00
|
|
|
Why use Libreboot?
|
|
|
|
==================
|
|
|
|
|
2023-11-03 13:58:39 +00:00
|
|
|
<img tabindex=1 class="r" style="max-width:25%;" src="https://av.libreboot.org/hp2170p/hp2170p.jpg" /><span class="f"><img src="https://av.libreboot.org/hp2170p/hp2170p.jpg" /></span>
|
|
|
|
|
2023-11-03 13:49:05 +00:00
|
|
|
If you're already inclined towards free software, maybe already a coreboot user,
|
|
|
|
Libreboot makes it easier to either get started or otherwise maintain coreboot
|
|
|
|
on your machine, via build automation. It provides regular tested releases,
|
|
|
|
pre-assembled, often with certain patches on top of coreboot (and other code)
|
|
|
|
to ensure stability. By comparison, coreboot uses a rolling-release model, with
|
2023-11-03 13:50:03 +00:00
|
|
|
a snapshot of the codebase every few months; it is very much developer-oriented,
|
2023-11-03 15:22:47 +00:00
|
|
|
whereas Libreboot is specifically crafted for end users. In other words, the
|
2023-11-03 15:24:06 +00:00
|
|
|
purpose of Libreboot is to *Just Work*. Direct configuration and installation
|
|
|
|
of coreboot is also possible, but Libreboot makes it *much* easier.
|
2023-11-03 13:49:05 +00:00
|
|
|
|
2023-11-03 13:30:35 +00:00
|
|
|
Libreboot gives you [freedoms](https://writefreesoftware.org/) that
|
|
|
|
you otherwise can't get with most other boot firmware, plus faster boot speeds
|
|
|
|
and [better security](docs/linux/grub_hardening.md). It's extremely powerful
|
|
|
|
and [configurable](docs/maintain/) for many use cases. If you're unhappy with
|
|
|
|
the restrictions (not to mention, security issues) imposed on you by proprietary
|
|
|
|
BIOS vendors, then Libreboot is one possible choice for you. Since it inherits
|
|
|
|
coreboot, it doesn't have any known backdoors in the code, nor does it contain
|
|
|
|
legacy cruft from the 1980s. Libreboot provides a sleek, fast boot experience
|
|
|
|
for Linux/BSD systems, based on coreboot which is regularly audited and improved.
|
|
|
|
|
2023-11-03 13:32:00 +00:00
|
|
|
Libreboot is more reliable than proprietary firmware. Many people use proprietary
|
2023-11-03 13:30:35 +00:00
|
|
|
(non-libre) boot firmware, even if they use [a libre OS](https://www.openbsd.org/).
|
2022-11-23 01:26:21 +00:00
|
|
|
Proprietary firmware often [contains](faq.html#intel) [backdoors](faq.html#amd),
|
2023-04-26 18:36:25 +00:00
|
|
|
and can be buggy. The Libreboot project was founded in December 2013, with the
|
2022-11-23 01:26:21 +00:00
|
|
|
express purpose of making coreboot firmware accessible for non-technical users.
|
2021-09-06 06:47:36 +00:00
|
|
|
|
2023-11-03 13:30:35 +00:00
|
|
|
Libreboot is a community-oriented project, with a focus on helping users escape
|
|
|
|
proprietary boot firmware; we ourselves want to live in a world where all software
|
|
|
|
is [free](https://writefreesoftware.org/), and so, Libreboot is an effort to
|
|
|
|
help get closer to that world. Unlike the big vendors, we don't try to stifle
|
|
|
|
you in any way, nor do we see you as a security threat; we regard the ability
|
|
|
|
to use, study, modify and redistribute software freely to be a human right that
|
|
|
|
everyone must have. Extended to computers, these are products that you purchased,
|
|
|
|
and so you should have the freedom to change them in any way you like. When you
|
|
|
|
see Intel talk about their *Boot Guard* (which prevents coreboot by only letting
|
|
|
|
firmware signed by them be executed) or other vendors imposing similar
|
|
|
|
restrictions, and you hear them talk about "security", they are only talking
|
|
|
|
about *their* security, not yours. In the Libreboot project, it is reversed; we
|
2023-11-03 14:08:13 +00:00
|
|
|
see Intel Boot Guard and similar such technologies as an attack on your freedom
|
2023-11-03 13:30:35 +00:00
|
|
|
over your own property (your computer), and so, we make it our mission to help
|
|
|
|
you [wrest](https://trmm.net/TOCTOU/) back such control.
|
|
|
|
|
2023-04-03 09:04:22 +00:00
|
|
|
Libreboot is not a fork of coreboot
|
2023-11-03 13:30:35 +00:00
|
|
|
===================================
|
2023-04-03 09:04:22 +00:00
|
|
|
|
2023-11-03 13:58:39 +00:00
|
|
|
<img tabindex=1 class="r" style="max-width:25%;" src="https://av.libreboot.org/t1650/t1650_grub.jpg" /><span class="f"><img src="https://av.libreboot.org/t1650/t1650_grub.jpg" /></span>
|
2023-04-24 11:44:10 +00:00
|
|
|
|
2023-04-03 09:04:22 +00:00
|
|
|
In fact, Libreboot tries to stay as close to *stock* coreboot as possible,
|
|
|
|
for each board, but with many different types of configuration provided
|
|
|
|
automatically by the Libreboot build system.
|
2022-01-02 07:35:30 +00:00
|
|
|
|
2023-04-24 11:59:01 +00:00
|
|
|
In the same way that *Alpine Linux* is a *Linux distribution*, Libreboot is
|
2022-01-02 07:35:30 +00:00
|
|
|
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
|
2023-04-25 10:10:56 +00:00
|
|
|
whatever other software you need, to prepare the ROM image. With *Libreboot*,
|
2024-02-25 08:44:06 +00:00
|
|
|
you can literally download from Git or a source archive, and run a simple script,
|
|
|
|
and it will build entire ROM images. An automated build system, named `lbmk`
|
2022-11-14 03:06:37 +00:00
|
|
|
(Libreboot MaKe), builds these ROM images automatically, without any user input
|
2022-01-02 07:35:30 +00:00
|
|
|
or intervention required. Configuration has already been performed in advance.
|
|
|
|
|
2023-04-25 10:10:56 +00:00
|
|
|
If you were to build regular coreboot, without using Libreboot's automated
|
2022-01-02 07:35:30 +00:00
|
|
|
build system, it would require a lot more intervention and decent technical
|
|
|
|
knowledge to produce a working configuration.
|
|
|
|
|
2023-04-24 11:59:01 +00:00
|
|
|
Regular binary releases of Libreboot provide these
|
2022-01-02 07:35:30 +00:00
|
|
|
ROM images pre-compiled, and you can simply install them, with no special
|
|
|
|
knowledge or skill except the ability to
|
|
|
|
follow [simplified instructions, written for non-technical
|
|
|
|
users](docs/install/).
|
|
|
|
|
2021-09-05 13:54:33 +00:00
|
|
|
How to help
|
|
|
|
-----------
|
|
|
|
|
2023-12-25 08:17:25 +00:00
|
|
|
The [tasks page](tasks/) lists tasks that could (will) be worked on. It will
|
|
|
|
be updated over time as more tasks are added/completede. If you want to help,
|
|
|
|
you could pick one of these tasks and work on it.
|
|
|
|
|
2023-04-26 01:20:28 +00:00
|
|
|
<img tabindex=1 class="l" style="max-width:15%;" src="https://av.libreboot.org/hp8200sff/grub_open.jpg" /><span class="f"><img src="https://av.libreboot.org/hp8200sff/grub_open.jpg" /></span>
|
|
|
|
|
2023-04-26 03:26:03 +00:00
|
|
|
The *single* biggest way you can help is to *add* new mainboards in Libreboot,
|
2023-04-24 03:38:23 +00:00
|
|
|
by submitting a config. Anything coreboot supports can be integrated in
|
|
|
|
Libreboot, with ROM images provided in releases. See:
|
|
|
|
|
|
|
|
* [Apply to become a board maintainer/tester](docs/maintain/testing.md)
|
|
|
|
* [Porting guide for new mainboards](docs/maintain/porting.md)
|
|
|
|
* [Libreboot build system documentation](docs/maintain/)
|
|
|
|
|
|
|
|
After that, there is build system maintenance (see above), and *documentation*
|
|
|
|
which we take seriously. Documentation is critical, in any project.
|
|
|
|
|
2023-04-24 04:07:03 +00:00
|
|
|
*User support* is also critical. Stick around on IRC, and if you're competent
|
|
|
|
to help someone with their issue (or wily enough to learn with them), that is
|
|
|
|
a great service to the project. A lot of people also ask for user support
|
|
|
|
on the `r/libreboot` subreddit.
|
|
|
|
|
2022-11-13 21:12:15 +00:00
|
|
|
You can check bugs listed on
|
2023-04-08 18:45:15 +00:00
|
|
|
the [bug tracker](https://codeberg.org/libreboot/lbmk/issues).
|
2021-09-05 13:54:33 +00:00
|
|
|
|
|
|
|
If you spot a bug and have a fix, [here are instructions for how to send
|
|
|
|
patches](git.md), and you can also report it. Also, this entire website is
|
|
|
|
written in Markdown and hosted in a [separate
|
2023-04-08 18:45:15 +00:00
|
|
|
repository](https://codeberg.org/libreboot/lbwww) where you can send patches.
|
2021-09-05 13:54:33 +00:00
|
|
|
|
2022-11-13 21:12:15 +00:00
|
|
|
Any and all development discussion and user support are all done on the IRC
|
2021-09-05 13:54:33 +00:00
|
|
|
channel. More information is on the [contact page](contact.md).
|
2023-04-27 17:51:07 +00:00
|
|
|
|
|
|
|
Translations needed, for libreboot.org
|
|
|
|
--------------------------------------
|
|
|
|
|
|
|
|
Libreboot currently has translated Web pages in Ukrainian and French (but not
|
|
|
|
for all pages, yet, on either language).
|
|
|
|
|
|
|
|
If you want to help with translations, you can translate pages, update existing
|
|
|
|
translations and submit your translated versions. For instructions, please
|
|
|
|
read:
|
|
|
|
|
|
|
|
[How to submit translations for libreboot.org](news/translations.md)
|
|
|
|
|
|
|
|
Even if someone is already working on translations in a given language, we can
|
|
|
|
always use multiple people. The more the merrier!
|