docs/gnulinux/encrypted_debian: don't tell the user to choose their own LV name
[libreboot.git] / README
1 Libreboot project
2
3 Libreboot documentation is under docs/
4 The website is https://libreboot.org/
5 License can be found in COPYING and through parts of the source tree.
6
7 Libreboot is a free BIOS or UEFI replacement (free as in freedom); libre boot 
8 firmware that initializes the hardware and starts a bootloader for your 
9 operating system. It's also an open source BIOS, but open source fails to 
10 promote freedom; please call libreboot free software.
11
12 Why use libreboot?
13
14 Many people use non-free boot firmware, even if they use GNU/Linux. Non-free 
15 BIOS/UEFI firmware often contains backdoors, can be slow and have severe bugs, 
16 where you are left helpless at the mercy of the developers; you have no freedom 
17 over your computing. By contrast, libreboot is building a world where 
18 everyone can use, study, adapt and share software, with true control and 
19 ownership over their technology. In other words, you should use Libreboot for 
20 your freedom's sake!
21
22 Libreboot is faster, more secure and more reliable than most non-free firmware, 
23 and can provide many advanced features (such as encrypted /boot/, GPG signature 
24 checking before booting your kernel, ability to load an OS from the flash chip, 
25 and more).
26
27 Libreboot's main upstream providers are coreboot (which we deblob, for hardware 
28 initialization), depthcharge (bootloader, and default libreboot payload on ARM), 
29 and GRUB (bootloader, and default libreboot payload on x86). We also 
30 integrate flashrom (for installing libreboot), and several of our own utilities, 
31 scripts and configuration files. All of this is integrated into a single, 
32 coherent package that is easy to use. We add our own patches to the various 
33 upstreams used, and where feasible try to merge upstream as much as possible.
34
35 Libreboot provides a fully automated build system and installation process, with 
36 documentation written for non-technical users, in an attempt to make the 
37 software as easy to use as possible. ROM images are provided, along with 
38 utilities, all built from the publicly distributed source code. 
39
40 This README is licensed under Creative Commons Zero 1.0:
41 https://creativecommons.org/publicdomain/zero/1.0/