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
|
|
|
...
|
|
|
|
|
|
2022-11-14 02:31:12 +00:00
|
|
|
The `libreboot` project provides
|
2021-09-01 05:56:49 +00:00
|
|
|
[freedom-respecting](https://www.gnu.org/philosophy/free-sw.html) *boot
|
|
|
|
|
firmware* that initializes the hardware (e.g. memory controller, CPU,
|
2022-11-16 22:10:02 +00:00
|
|
|
peripherals) on [specific Intel/AMD x86 and ARM targets](docs/hardware/), which
|
|
|
|
|
then starts a bootloader for your operating system. [GNU+Linux](docs/gnulinux/)
|
2021-09-01 05:56:49 +00:00
|
|
|
and [BSD](docs/bsd/) are well-supported. It replaces proprietary BIOS/UEFI
|
|
|
|
|
firmware. Help is available
|
2022-11-14 02:31:12 +00:00
|
|
|
via [\#libreboot](https://web.libera.chat/#libreboot)
|
2021-09-01 05:56:49 +00:00
|
|
|
on [Libera](https://libera.chat/) IRC.
|
2021-08-30 07:14:05 +00:00
|
|
|
|
2022-11-16 22:13:25 +00:00
|
|
|
**[Osboot recently merged with and became part of Libreboot.](news/merge.md)
|
|
|
|
|
Many new targets are now supported but as of this date, 16 November 2022, you
|
|
|
|
|
should (for now) expect bugs in the build system and some documentation is
|
|
|
|
|
missing. This is being worked on, so that a new testing release of Libreboot
|
|
|
|
|
can be completed as soon as possible.**
|
|
|
|
|
|
2022-11-14 02:31:12 +00:00
|
|
|
Why should you use *libreboot*?
|
2022-11-13 21:12:15 +00:00
|
|
|
----------------------------
|
2021-09-05 12:26:15 +00:00
|
|
|
|
2021-09-06 06:38:28 +00:00
|
|
|
You have rights. The right to privacy, freedom of thought, freedom of speech
|
|
|
|
|
and the right to read. [Free
|
2021-09-06 06:47:36 +00:00
|
|
|
software](https://www.gnu.org/philosophy/free-sw.html) gives you these rights.
|
|
|
|
|
Your freedom matters.
|
2021-09-06 06:38:28 +00:00
|
|
|
[Right to repair](https://vid.puffyan.us/watch?v=Npd_xDuNi9k) matters.
|
|
|
|
|
Many people use [proprietary](https://www.gnu.org/proprietary/proprietary.html)
|
|
|
|
|
boot firmware, even if they use [GNU+Linux](https://www.gnu.org/distros/).
|
|
|
|
|
Non-free firmware often [contains](faq.html#intel) [backdoors](faq.html#amd),
|
2022-11-15 21:52:55 +00:00
|
|
|
and can be buggy. The libreboot project was founded in in December 2013, with the
|
2022-11-13 21:12:15 +00:00
|
|
|
express purpose of making Free Software accessible for non-technical users at
|
2022-11-14 02:31:12 +00:00
|
|
|
the firmware level. It's true that `libreboot` can be called Open Source, [but you
|
2022-11-13 21:12:15 +00:00
|
|
|
should call it Free
|
2021-09-06 06:47:36 +00:00
|
|
|
Software](https://www.gnu.org/philosophy/open-source-misses-the-point.en.html).
|
|
|
|
|
|
2022-11-14 02:31:12 +00:00
|
|
|
The `libreboot` project uses [coreboot](https://www.coreboot.org/) for [hardware
|
2021-09-01 09:45:05 +00:00
|
|
|
initialization](https://doc.coreboot.org/getting_started/architecture.html).
|
2021-09-06 06:38:28 +00:00
|
|
|
Coreboot is notoriously difficult to install for most non-technical users; it
|
|
|
|
|
handles only basic initialization and jumps to a separate
|
2021-09-01 09:45:05 +00:00
|
|
|
[payload](https://doc.coreboot.org/payloads.html) program (e.g.
|
|
|
|
|
[GRUB](https://www.gnu.org/software/grub/),
|
|
|
|
|
[Tianocore](https://www.tianocore.org/)), which must also be configured.
|
2022-11-14 02:31:12 +00:00
|
|
|
*The libreboot software solves this problem*; it is a *coreboot distribution* with
|
2021-09-01 10:07:13 +00:00
|
|
|
an [automated build system](docs/build/) that builds complete *ROM images*, for
|
2021-09-06 02:04:42 +00:00
|
|
|
more robust installation. Documentation is provided.
|
2021-08-30 07:14:05 +00:00
|
|
|
|
2022-11-14 02:31:12 +00:00
|
|
|
How does libreboot differ from regular coreboot?
|
2022-11-13 21:12:15 +00:00
|
|
|
---------------------------------------------
|
2022-01-02 07:35:30 +00:00
|
|
|
|
2022-11-14 02:31:12 +00:00
|
|
|
In the same way that *Debian* is a GNU+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
|
2022-11-14 02:31:12 +00:00
|
|
|
whatever other software you need, to prepare the ROM image. With *libreboot*,
|
2022-01-02 07:35:30 +00:00
|
|
|
you can literally download from Git or a source archive, and run `make`, and it
|
2022-11-14 02:31:12 +00:00
|
|
|
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.
|
|
|
|
|
|
2022-11-14 02:31:12 +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.
|
|
|
|
|
|
2022-11-14 03:06:37 +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
|
|
|
|
|
-----------
|
|
|
|
|
|
2022-11-13 21:12:15 +00:00
|
|
|
You can check bugs listed on
|
2022-11-14 02:31:12 +00:00
|
|
|
the [bug tracker](https://notabug.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
|
2022-11-16 22:56:15 +00:00
|
|
|
repository](https://notabug.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).
|
