https://github.com/wolegis/mkinitcpio-systemd-extras
Collection of mkinitcpio install hooks for systemd based initramfs
https://github.com/wolegis/mkinitcpio-systemd-extras
archlinux mkinitcpio-hook mkinitcpio-systemd
Last synced: about 1 month ago
JSON representation
Collection of mkinitcpio install hooks for systemd based initramfs
- Host: GitHub
- URL: https://github.com/wolegis/mkinitcpio-systemd-extras
- Owner: wolegis
- License: gpl-3.0
- Created: 2022-11-13T13:48:52.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-12-25T22:28:59.000Z (3 months ago)
- Last Synced: 2025-12-27T08:21:08.940Z (3 months ago)
- Topics: archlinux, mkinitcpio-hook, mkinitcpio-systemd
- Language: Shell
- Homepage:
- Size: 61.5 KB
- Stars: 26
- Watchers: 2
- Forks: 12
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mkinitcpio-systemd-extras
This is a collection of `mkinitcpio` install hooks for systemd based
initramfs.
[mkinitcpio](https://wiki.archlinux.org/title/Mkinitcpio) is an Arch Linux
specific tool to generate images for the [initial ramdisk
(initramfs)](https://wiki.archlinux.org/title/Arch_boot_process#initramfs)
required during early boot of an Arch Linux installation. There are two options
how this boot phase can be executed:
* A bunch of shell scripts run by the busybox shell.
* Systemd is started already in this initramfs environment and any
initialization is performed by means of systemd units.
This repository provides so-called install hooks that can be used in
`mkinitcpio`'s configuration file `mkinitcpio.conf`. They complement the set of
install hooks for a systemd based boot process provided by other packages like
e.g. *systemd*, *mkinitcpio*, *cryptsetup*, *lvm2*, ...
> [!CAUTION]
> Tinkering with the boot process of your system is always risky. Make sure
> that you always have at least one option to back out.
## Installation
*mkinitcpio-systemd-extras* is available as a
[package](https://aur.archlinux.org/packages/mkinitcpio-systemd-extras) in Arch
Linux' User Repository (AUR). Use `makepkg` to build and `pacman` to install
the package. (Alternatively you may use your favorite [AUR
helper](https://wiki.archlinux.org/title/AUR_helpers).)
## Usage
See the short help available for each install hook, e.g.
```bash
mkinitcpio -H sd-tinyssh
```
For more details see the corresponding [wiki pages](../../wiki).
## Contribution
You are welcome to provide additional hooks or improvements of the existing
ones in the form of pull requests. Mind that all hooks must provide some degree
of general usefulness.