manuel
/
gentoo-install
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update readme

This commit is contained in:
oddlama 2020-04-21 16:15:49 +02:00
parent 99491a3e22
commit 97f65b92c1
No known key found for this signature in database
GPG Key ID: 88EA325D51D53908
1 changed files with 7 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
README.md
View File

@ -1,13 +1,14 @@
**TL;DR:** Edit `scripts/config.sh` and execute `./install` in any live system. **TL;DR:** Edit `scripts/config.sh` and execute `./install` in any live system.
EFI is required. This will partition the selected disk (with confirmation), and properly This will apply the selected partitioning scheme (with confirmation), and properly
install the selected stage3 gentoo system. The new system will be bootable with install the selected stage3 gentoo system. The new system will be bootable with
`vanilla-kernel-bin` as the kernel. The script can optionally install sshd and `vanilla-kernel-bin` as the kernel. The script can optionally install sshd and
ansible to allow for easier management of the new system. Afterwards, you can continue ansible to allow for easier management of the new system. Afterwards, you can continue
to roll-out your own advanced setup (LUKS, RAID, custom kernel). to deploy your own specific setup.
# Gentoo installation script # Gentoo installation script
This script performs a reasonably minimal installation of gentoo for an EFI system. This script performs a reasonably minimal installation of gentoo. An EFI system is highly
recommended, but legacy BIOS boot is still supported.
It does everything from the ground up, including creating partitions, downloading It does everything from the ground up, including creating partitions, downloading
and extracting the stage3 archive, initial system configuration and optionally installing and extracting the stage3 archive, initial system configuration and optionally installing
some additional software. The script only supports OpenRC and not systemd. some additional software. The script only supports OpenRC and not systemd.
@ -15,16 +16,14 @@ some additional software. The script only supports OpenRC and not systemd.
The system will temporarily use `sys-kernel/vanilla-kernel-bin`, which should be suitable The system will temporarily use `sys-kernel/vanilla-kernel-bin`, which should be suitable
to boot most systems out of the box. I strongly recommend you to replace this kernel to boot most systems out of the box. I strongly recommend you to replace this kernel
with a custom built one, when the system is functional. If you are looking for a way with a custom built one, when the system is functional. If you are looking for a way
to properly manage your kernel configuration parameters, have a look at [kernconf](https://github.com/oddlama/kernconf). to detect and manage your kernel configuration, have a look at [autokernel](https://github.com/oddlama/autokernel).
There you will also find information on how to select the correct options for your system,
and information on kernel hardening.
## Overview ## Overview
Here is a quick overview of what this script does: Here is a quick overview of what this script does:
* Does everything minus something * Does everything minus something
* Partition the device (efi, optional swap, linux root) * Partition disks (supports gpt, raid, luks)
* Download and cryptographically verify the newest stage3 tarball * Download and cryptographically verify the newest stage3 tarball
* Extract the stage3 tarball * Extract the stage3 tarball
* Sync portage tree * Sync portage tree
@ -34,7 +33,7 @@ Here is a quick overview of what this script does:
- Set keymap - Set keymap
- Generate and select locale - Generate and select locale
- Prepare `zz-autounmask` files for portage autounmasking - Prepare `zz-autounmask` files for portage autounmasking
* Select best 4 gentoo portage mirrors * Select best gentoo portage mirrors
* Install git (so you can add your portage overlays later) * Install git (so you can add your portage overlays later)
* Install `sys-kernel/vanilla-kernel-bin` (temporarily, until you replace it) * Install `sys-kernel/vanilla-kernel-bin` (temporarily, until you replace it)
* Copy kernel to efi partition * Copy kernel to efi partition
@ -74,12 +73,6 @@ The config file `scripts/config.sh` allows you to adjust some parameters of the
The most important ones will probably be the device to partition, and the stage3 tarball name The most important ones will probably be the device to partition, and the stage3 tarball name
to install. By default you will get the hardened nomultilib profile without systemd. to install. By default you will get the hardened nomultilib profile without systemd.
### Using existing partitions
If you want to use existing partitions, you will have to set `ENABLE_PARTITIONING=false`.
As the script uses uuids to refer to partitions, you will have to set the corresponding
partition uuid variables in the config (all variables beginning with `PARTITION_UUID_`).
## (Optional) sshd ## (Optional) sshd
The script can provide a fully configured ssh daemon with reasonably good security settings. The script can provide a fully configured ssh daemon with reasonably good security settings.