mirror of
https://github.com/suikan4github/kaiten-yaki.git
synced 2025-12-20 10:31:17 -03:00
64 lines
3.2 KiB
Markdown
64 lines
3.2 KiB
Markdown
# Kaiten-yaki: Full disk encryption install script for Linux
|
|
Kaiten-yaki is a script set to install Linux to your desktop system. With these scripts, you can install Ubuntu/Void Linux to an encrypted partition easily.
|
|
|
|
The followings are the list of functionalities:
|
|
- Ubuntu and Void Linux.
|
|
- Help to install from LiveCD/USB.
|
|
- Invoke GUI/TUI installer automatically at the middle of script execution, for the ease of installation.
|
|
- Automatic detection of BIOS/EFI firmware and create MBR/GPT, respectively.
|
|
- Create an EFI partition, if needed.
|
|
- Support multiple boot in a LUKS partition.
|
|
- The "/boot" is located in the same logical volume as the "/".
|
|
- The swap logical volume is located inside the encrypted volume.
|
|
- You need to type a passphrase only once in the boot sequence.
|
|
|
|
With the configuration parameters, you can customize each installation. For example, you can configure the system to have 2, 3, or 4,... distributions in an HDD/SSD, as you want.
|
|
|
|
Following is the HDD/SSD partitioning plan of these scripts ( In the case of BIOS, the disk has MBR and doesn't have an EFI partition).
|
|
|
|
|
|
|
|
The logical volume size of each Linux distribution (LVROOTSIZE) can be customized from a configuration parameter. Also, the swap volume size is customizable.
|
|
|
|
As depicted above, the LVM volume group has only one physical volume.
|
|
|
|
# Tested environment
|
|
These scripts are tested with the following environment.
|
|
- VMWare Workstation 15.5.7 ( EFI/BIOS )
|
|
- ThinkPad X220 (BIOS)
|
|
- Ubuntu 20.04.2 amd64 desktop
|
|
- Ubuntu 21.04 amd64 desktop
|
|
- Ubuntu Mate 20.04.2 amd64 desktop
|
|
- void-live-x86_64-20210218-mate.iso
|
|
- void-live-x86_64-musl-20210218-mate.iso
|
|
- void-live-x86_64-20210218.iso
|
|
|
|
# Installation
|
|
Rough procedure of the installation is as followings :
|
|
1. Start the PC with the LiveCD/LiveUSB of the distribution to install
|
|
1. Download this repository from GitHub
|
|
3. Run the script.
|
|
|
|
The detail procedure is explained in the [INSTALL.md](INSTALL.md).
|
|
|
|
# Known issues
|
|
If you install two or more Void Linux into the EFI system, only the last one can boot without trouble. This is not the problem of Kaiten-yaki.
|
|
|
|
# Variants considerations
|
|
Ubuntu has several variants ( flavors ). While while only the MATE flavor is tested, other flavors may work correctly as far as it uses Ubiquity installer.
|
|
|
|
# Application notes
|
|
- [AN01 : How to recover from the mistyping of the passphrase](appnote/an01_howtorecover.md)
|
|
- [AN02 : Managing LUKS key slots](appnote/an02_keyslot.md)
|
|
- [AN03 : The ITERTIME parameter and vulnerability](appnote/an03_itertime.md)
|
|
- [AN04 : How to make LUKS volume to the favorite partition](appnote/an04_favoritepartition.md)
|
|
|
|
# Acknowledgments
|
|
These scripts are based on the script by [myn's diary](https://myn.hatenablog.jp/entry/install-ubuntu-focal-with-lvm-on-luks). That page contains rich information, hint, and techniques around the encrypted volume and Ubiquity installer.
|
|
|
|
Also, the following documents were very important to study how Void Linux installation works.
|
|
- [Full Disk Encryption](https://docs.voidlinux.org/installation/guides/fde.html) in the Void Handbook.
|
|
- [Install LVM LUKS](https://wiki.voidlinux.org/Install_LVM_LUKS) (deprecated)
|
|
# Kaiten-yaki
|
|
|
|
|