lbwww/site/index.md

125 lines
6.0 KiB
Markdown
Raw Normal View History

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
...
The *Libreboot* project provides
2023-03-20 04:32:20 +00:00
[libre](freedom-status.md) *boot
2021-09-01 05:56:49 +00:00
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
2023-04-09 21:57:42 +00:00
then starts a bootloader for your operating system. [Linux](docs/linux/)
2021-09-01 05:56:49 +00:00
and [BSD](docs/bsd/) are well-supported. It replaces proprietary BIOS/UEFI
firmware. Help is available
via [\#libreboot](https://web.libera.chat/#libreboot)
2021-09-01 05:56:49 +00:00
on [Libera](https://libera.chat/) IRC.
<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>
**NEW RELEASE: The latest release is Libreboot 20230625, released on
25 June 2023.
See: [Libreboot 20230625 release announcement](news/libreboot20230625.md).**
2022-12-14 19:09:03 +00:00
2023-04-25 10:10:56 +00:00
Why should you use *Libreboot*?
2022-11-13 21:12:15 +00:00
----------------------------
2021-09-05 12:26:15 +00:00
Libreboot gives you [freedoms](https://writefreesoftware.org/) that
2023-04-24 12:11:48 +00:00
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.
2022-11-23 01:26:21 +00:00
2021-09-06 06:38:28 +00:00
You have rights. The right to privacy, freedom of thought, freedom of speech
2022-11-23 01:26:21 +00:00
and the right to read. In this context, Libreboot gives you these rights.
2021-09-06 06:47:36 +00:00
Your freedom matters.
2023-03-03 04:53:23 +00:00
[Right to repair](https://yewtu.be/watch?v=Npd_xDuNi9k) matters.
2022-11-23 01:26:21 +00:00
Many people use proprietary (non-libre)
boot firmware, even if they use [a libre OS](https://www.openbsd.org/).
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
The Libreboot project uses [coreboot](https://www.coreboot.org/) for [hardware
2022-11-23 01:26:21 +00:00
initialisation](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.
2023-04-25 10:12:22 +00:00
*Libreboot 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.
2023-04-03 09:04:22 +00:00
Libreboot is not a fork of coreboot
-----------------------------------
<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-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.
In the same way that *Alpine Linux* is a *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
2023-04-25 10:10:56 +00:00
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.
2023-04-25 10:10:56 +00:00
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 [simplified instructions, written for non-technical
users](docs/install/).
2021-09-05 13:54:33 +00:00
How to help
-----------
<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,
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!