shu/void-linux-pbp-installer
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

add unmaintained note

Browse Source
This commit is contained in:
Sebastian Hugentobler 2024-03-28 16:05:46 +01:00
parent 46be773a1d
commit d8b71f3ed5
Signed by: shu
GPG Key ID: BB32CF3CA052C2F0
2 changed files with 58 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

85
README.md
View File

@ -1,37 +1,49 @@
# UNMAINTAINED
I no longer use void linux, excellent distribution that it is.
# Install Scripts for Void Linux on Pinebook Pro # Install Scripts for Void Linux on Pinebook Pro
Before using either of the scripts in this repository, read through them to Before using either of the scripts in this repository, read through them to
clearly understand what they do. They are very opinionated and specifically clearly understand what they do. They are very opinionated and specifically
written to cater to my own needs (for example the use of `sudo`, other people written to cater to my own needs (for example the use of `sudo`, other people
might have different setups). It is, however, easy to change things around. might have different setups). It is, however, easy to change things around.
By default, the `bootstrap` script creates a minimal installation on the emmc storage, By default, the `bootstrap` script creates a minimal installation on the emmc
with full disk encryption (with an unencrypted boot partition) via lvm on luks. Two volumes `swap` and `root` are created, storage, with full disk encryption (with an unencrypted boot partition) via lvm
the latter is formatted with an xfs filesystem. Additionally one user is created on luks. Two volumes `swap` and `root` are created, the latter is formatted with
(with access to sudo via the wheel group) and keymap, hostname and timezone get set. an xfs filesystem. Additionally one user is created (with access to sudo via the
wheel group) and keymap, hostname and timezone get set.
This gets you to a booting system, going on from there is out of scope here This gets you to a booting system, going on from there is out of scope here as
as there are many ways to do that (for myself, I use `stow` to set up everything). there are many ways to do that (for myself, I use `stow` to set up everything).
An important thing to keep in mind is that not all commands in the `bootstrap` An important thing to keep in mind is that not all commands in the `bootstrap`
script are idempotent, that makes it all the more important to understand what they script are idempotent, that makes it all the more important to understand what
do and to be sure to backup all important data. they do and to be sure to backup all important data.
Pre-built images can be downloaded from the [releases](https://code.vanwa.ch/sebastian/void-linux-installer/-/releases) page Pre-built images can be downloaded from the
[releases](https://code.vanwa.ch/sebastian/void-linux-installer/-/releases) page
(those might be outdated though). (those might be outdated though).
User and password for the live image are the standard void linux ones (`root/voidlinux`). User and password for the live image are the standard void linux ones
(`root/voidlinux`).
# Scripts # Scripts
## mk_pbp_img ## mk_pbp_img
Create a live image to boot void linux on the pinebook pro. Needs to be run on an
existing void linux system (docker might be possible with a working buildx and some adaptions with the mounting of filesystems). Create a live image to boot void linux on the pinebook pro. Needs to be run on
an existing void linux system (docker might be possible with a working buildx
and some adaptions with the mounting of filesystems).
A copy of the [void-mklive](https://github.com/void-linux/void-mklive.git) A copy of the [void-mklive](https://github.com/void-linux/void-mklive.git)
repository is downloaded next to the script into `.void-mklive` and used for repository is downloaded next to the script into `.void-mklive` and used for
building the image. building the image.
The script assumes it is running on an `x86_64` architecture, if that is not the case, The script assumes it is running on an `x86_64` architecture, if that is not the
it needs to be changed (this applies to the use of `qemu-aarch64-static` to get a chroot). case, it needs to be changed (this applies to the use of `qemu-aarch64-static`
to get a chroot).
The following tools need to be accessible in `PATH`: The following tools need to be accessible in `PATH`:
@ -41,33 +53,40 @@ The following tools need to be accessible in `PATH`:
- sudo - sudo
- xz - xz
If there is an argument provided to the script, it is treated as the folder to where If there is an argument provided to the script, it is treated as the folder to
the compressed image is written, if no argument is given, the current working where the compressed image is written, if no argument is given, the current
directory is used. working directory is used.
After a successful build, the finished image can be found in the directory described After a successful build, the finished image can be found in the directory
above with a filename of `void-pbp.img.xz` described above with a filename of `void-pbp.img.xz`
Write it to a microSD card as such: Write it to a microSD card as such:
- `xz -d < void-pbp.img.xz | sudo dd of=/dev/mmcblk0 bs=4M status=progress` - `xz -d < void-pbp.img.xz | sudo dd of=/dev/mmcblk0 bs=4M status=progress`
- `sudo sync` - `sudo sync`
Be ***very*** careful to get the parameter for `of` right, otherwise you can destroy your system. Be **_very_** careful to get the parameter for `of` right, otherwise you can
destroy your system.
MicroSD cards can be fickle, it sometimes is helpful to not take them out immediately, even after running `sync`. MicroSD cards can be fickle, it sometimes is helpful to not take them out
If booting from the card hangs, write the image again onto it or use a different card. immediately, even after running `sync`. If booting from the card hangs, write
the image again onto it or use a different card.
## bootstrap ## bootstrap
Install void linux to the internal mmc storage of the pinebook pro or use it for some
maintenance task.
Be aware that the time needs to be set in ***UTC**, otherwise package installation might not work. Install void linux to the internal mmc storage of the pinebook pro or use it for
some maintenance task.
If running on a pinebook pro with an ISO keyboard, run `loadkeys uk` to load the correct keymap. Be aware that the time needs to be set in **\*UTC**, otherwise package
installation might not work.
If running on a pinebook pro with an ISO keyboard, run `loadkeys uk` to load the
correct keymap.
Run it in either of two ways: Run it in either of two ways:
### non-interactive ### non-interactive
`bootstrap full` `bootstrap full`
Run a full installation, this will overwrite all data on the storage. Run a full installation, this will overwrite all data on the storage.
@ -75,14 +94,14 @@ Run a full installation, this will overwrite all data on the storage.
Runs the `full_install` command internally. Runs the `full_install` command internally.
### interactive ### interactive
`bootstrap` `bootstrap`
Run `help` to get a list of commands you can run and quit interactive mode Run `help` to get a list of commands you can run and quit interactive mode with
with typing `exit`. typing `exit`.
A useful thing to do here is the `repair` command. It sets up all the needed filesystems A useful thing to do here is the `repair` command. It sets up all the needed
and opens a chroot. filesystems and opens a chroot.
Again, it is highly recommended to read what the respective commands do and to adapt
them to your own needs.
Again, it is highly recommended to read what the respective commands do and to
adapt them to your own needs.

2
bootstrap
View File

@ -106,7 +106,7 @@ create_lvm() {
pvcreate /dev/mapper/void pvcreate /dev/mapper/void
vgcreate void /dev/mapper/void vgcreate void /dev/mapper/void
lvcreate -L 4G void -n swap lvcreate -L 48G void -n swap
lvcreate -l 100%FREE void -n root lvcreate -l 100%FREE void -n root
} }