quico-os-setup/arch-zbm
1
0
Fork 0
Code Issues 3 Pull Requests Packages Projects Releases Wiki Activity

Compare commits

base: quico-os-setup:0e9314ef6f184cc07a75e29efde34ace394b3c63
Branches Tags
quico-os-setup:main
..
compare: quico-os-setup:a5733bdb56c4e1cd332768aee0805750c22a4ff7
Branches Tags
quico-os-setup:main

2 Commits
0e9314ef6f ... a5733bdb56

Author SHA1 Message Date
hygienic-books
a5733bdb56 docs(zbm): Trim unnecessary newline (#1) 2023-02-20 00:59:36 +01:00
hygienic-books
db0e0f0b7c docs(zbm): Harmonize unordered list bullet points (#1) 2023-02-20 00:57:54 +01:00
1 changed files with 35 additions and 35 deletions
Expand all files Collapse all files

70
README.md
View File

@@ -39,27 +39,27 @@ The scripts takes the following installation steps.
We make the following opinionated flavor choices. Feel free to change them to your liking. We make the following opinionated flavor choices. Feel free to change them to your liking.
* Arch Linux locale is set to `en_US.UTF-8` - Arch Linux locale is set to `en_US.UTF-8`
* Keymap is `de-latin1` - Keymap is `de-latin1`
* Consult `/etc/vconsole.conf` - Consult `/etc/vconsole.conf`
* Change `zfs set org.zfsbootmenu:commandline=...` - Change `zfs set org.zfsbootmenu:commandline=...`
* No X.Org Server, Wayland compositors or other GUI elements get installed - No X.Org Server, Wayland compositors or other GUI elements get installed
* Timezone is `Etc/UTC` - Timezone is `Etc/UTC`
* Check `timedatectl set-timezone <tzdata-zone>` - Check `timedatectl set-timezone <tzdata-zone>`
# Post-run manual steps # Post-run manual steps
After installation you're going to want to at least touch these points in your new Arch Linux install: After installation you're going to want to at least touch these points in your new Arch Linux install:
* Package manager hook: `pacman` does not have a hook to do ZFS snapshots - Package manager hook: `pacman` does not have a hook to do ZFS snapshots
* See [this GitHub gist](https://gist.github.com/Soulsuke/6a7d1f09f7fef968a2f32e0ff32a5c4c#file-arch_on_zfs-txt-L238) and [zfs-snapshotter.bash](https://github.com/Soulsuke/arch-zfs-tools/blob/master/zfs-snapshotter.bash) for inspiration - See [this GitHub gist](https://gist.github.com/Soulsuke/6a7d1f09f7fef968a2f32e0ff32a5c4c#file-arch_on_zfs-txt-L238) and [zfs-snapshotter.bash](https://github.com/Soulsuke/arch-zfs-tools/blob/master/zfs-snapshotter.bash) for inspiration
* Hostname: Installation chose a pseudo-randomly generated 8-character string with `pwgen` - Hostname: Installation chose a pseudo-randomly generated 8-character string with `pwgen`
* Check `hostnamectl set-hostname <hostname>` - Check `hostnamectl set-hostname <hostname>`
* Unprivileged user accounts: The OS was installed with `root` and unprivileged `build` users - Unprivileged user accounts: The OS was installed with `root` and unprivileged `build` users
* Passwords - Passwords
* ZFS: The password for all datasets underneath `zpool` is `password`. - ZFS: The password for all datasets underneath `zpool` is `password`.
* Local `root` account: The local `root` account's password is `password`. - Local `root` account: The local `root` account's password is `password`.
* Arch User Repository (AUR) helper: We installed [paru](https://github.com/Morganamilo/paru) as our AUR helper, we installed from GitHub via `makepkg -si`. - Arch User Repository (AUR) helper: We installed [paru](https://github.com/Morganamilo/paru) as our AUR helper, we installed from GitHub via `makepkg -si`.
# Development # Development
@@ -71,20 +71,20 @@ This project uses [Conventional Commits](https://www.conventionalcommits.org/) f
Commit _types_ besides `fix` and `feat` are: Commit _types_ besides `fix` and `feat` are:
* `build`: Project structure, directory layout, build instructions for roll-out - `build`: Project structure, directory layout, build instructions for roll-out
* `refactor`: Keeping functionality while streamlining or otherwise improving function flow - `refactor`: Keeping functionality while streamlining or otherwise improving function flow
* `test`: Working on test coverage - `test`: Working on test coverage
* `docs`: Documentation for project or components - `docs`: Documentation for project or components
### Commit scopes ### Commit scopes
The following _scopes_ are known for this project. A Conventional Commits commit message may optionally use one of the following scopes or none: The following _scopes_ are known for this project. A Conventional Commits commit message may optionally use one of the following scopes or none:
* `iso`: Changing Arch Linux ISO CD - `iso`: Changing Arch Linux ISO CD
* `zbm`: Adjusting ZFSBootMenu's behavior - `zbm`: Adjusting ZFSBootMenu's behavior
* `zfs`: A change to how ZFS interacts with the system, either a pool or a dataset - `zfs`: A change to how ZFS interacts with the system, either a pool or a dataset
* `os`: Getting an perating system set up to correctly work in a ZFS boot environment - `os`: Getting an perating system set up to correctly work in a ZFS boot environment
* `meta`: Affects the project's repo layout, readme content, file names etc. - `meta`: Affects the project's repo layout, readme content, file names etc.
# Credits # Credits
@@ -92,13 +92,13 @@ Most of what's here was shamelessly copied and slightly adapted for personal use
Thanks to: Thanks to:
* Jonathan Kirszling: - Jonathan Kirszling:
* [github.com/eoli3n/arch-config/tree/master/scripts/zfs/install](https://github.com/eoli3n/arch-config/tree/master/scripts/zfs/install) - [github.com/eoli3n/arch-config/tree/master/scripts/zfs/install](https://github.com/eoli3n/arch-config/tree/master/scripts/zfs/install)
* [github.com/eoli3n/archiso-zfs](https://github.com/eoli3n/archiso-zfs) - [github.com/eoli3n/archiso-zfs](https://github.com/eoli3n/archiso-zfs)
* Maurizio Oliveri: - Maurizio Oliveri:
* [github.com/Soulsuke/arch-zfs-tools](https://github.com/Soulsuke/arch-zfs-tools) - [github.com/Soulsuke/arch-zfs-tools](https://github.com/Soulsuke/arch-zfs-tools)
* [gist.github.com/Soulsuke/6a7d1f09f7fef968a2f32e0ff32a5c4c](https://gist.github.com/Soulsuke/6a7d1f09f7fef968a2f32e0ff32a5c4c) - [gist.github.com/Soulsuke/6a7d1f09f7fef968a2f32e0ff32a5c4c](https://gist.github.com/Soulsuke/6a7d1f09f7fef968a2f32e0ff32a5c4c)
* Zach Dykstra, Andrew J. Hesford and all other [ZFSBootMenu contributors](https://github.com/zbm-dev/zfsbootmenu/graphs/contributors): - Zach Dykstra, Andrew J. Hesford and all other [ZFSBootMenu contributors](https://github.com/zbm-dev/zfsbootmenu/graphs/contributors):
* Their [ZFSBootMenu testing helper scripts](https://github.com/zbm-dev/zfsbootmenu/tree/master/testing/helpers) ([chroot-arch.sh](https://github.com/zbm-dev/zfsbootmenu/blob/master/testing/helpers/chroot-arch.sh), [install-arch.sh](https://github.com/zbm-dev/zfsbootmenu/blob/master/testing/helpers/install-arch.sh)) - Their [ZFSBootMenu testing helper scripts](https://github.com/zbm-dev/zfsbootmenu/tree/master/testing/helpers) ([chroot-arch.sh](https://github.com/zbm-dev/zfsbootmenu/blob/master/testing/helpers/chroot-arch.sh), [install-arch.sh](https://github.com/zbm-dev/zfsbootmenu/blob/master/testing/helpers/install-arch.sh))
* [github.com/kongkrit](https://github.com/kongkrit): - [github.com/kongkrit](https://github.com/kongkrit):
* [gist.github.com/kongkrit/a0585e179e33c2adf92db4050ec5171d](https://gist.github.com/kongkrit/a0585e179e33c2adf92db4050ec5171d) - [gist.github.com/kongkrit/a0585e179e33c2adf92db4050ec5171d](https://gist.github.com/kongkrit/a0585e179e33c2adf92db4050ec5171d)