{"id":43702557,"url":"https://github.com/zeppe-lin/mkinitramfs","last_synced_at":"2026-04-01T22:19:16.218Z","repository":{"id":143725013,"uuid":"584290531","full_name":"zeppe-lin/mkinitramfs","owner":"zeppe-lin","description":"Initramfs generator","archived":false,"fork":false,"pushed_at":"2026-03-21T22:17:06.000Z","size":2140,"stargazers_count":2,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-22T09:56:59.076Z","etag":null,"topics":["initramfs","initramfs-generator","mkinitramfs"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zeppe-lin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":"COPYRIGHT","agents":null,"dco":null,"cla":null}},"created_at":"2023-01-02T06:00:10.000Z","updated_at":"2026-03-21T22:17:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"ac048ea8-30d5-4212-8a24-a48dac5eb44e","html_url":"https://github.com/zeppe-lin/mkinitramfs","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/zeppe-lin/mkinitramfs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeppe-lin%2Fmkinitramfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeppe-lin%2Fmkinitramfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeppe-lin%2Fmkinitramfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeppe-lin%2Fmkinitramfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zeppe-lin","download_url":"https://codeload.github.com/zeppe-lin/mkinitramfs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeppe-lin%2Fmkinitramfs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31292639,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["initramfs","initramfs-generator","mkinitramfs"],"created_at":"2026-02-05T05:09:59.875Z","updated_at":"2026-04-01T22:19:16.209Z","avatar_url":"https://github.com/zeppe-lin.png","language":"Shell","funding_links":["https://patreon.com/illiliti"],"categories":[],"sub_categories":[],"readme":"OVERVIEW\n========\n\n`mkinitramfs` generates bootable initramfs images for Linux systems.\n\nIt is a fork of illiliti's `tinyramfs` at commit `8abfcc9`\n(Fri May 21 2021), with the following changes:\n  * Bash completion support\n  * GNU-style options and usage output\n  * Command-line parsing via GNU `getopt(1)`\n  * Use of `local` to prevent namespace pollution\n  * Support for `rootdelay` kernel parameter\n  * Experimental `smdev` hook\n  * `luks` hook: prompts for password if header/keyfile is missing\n  * `extrafiles` directive: copy arbitrary files into image\n  * `resume` hook: supports hibernation resume from swap partitions or\n    files\n  * Split `keymap` hook into `loadkmap` and `loadkeys` (supports\n    BusyBox and kmod)\n  * `\u003chook\u003e.post` - post-generation hooks\n\nSee the git log for full history.\n\nThe original sources can be downloaded from:\n  1. https://github.com/illiliti/tinyramfs\n  2. https://github.com/illiliti/tinyramfs/archive/8abfcc9/tinyramfs-8abfcc9.zip\n\n---\n\nFEATURES\n========\n\nThe following advantages can be distinguished:\n  * No bashisms, only POSIX `sh(1p)` (with `local` exception)\n  * Portable, no distribution-specific\n  * Simple configuration\n  * Build-time and init-time hooks\n  * LUKS (detached header, key, password), LVM\n  * smdev, mdev, mdevd, eudev, systemd-udevd\n\n---\n\nREQUIREMENTS\n============\n\nKernel Configuration\n--------------------\n\nThe kernel must be built with:\n\n```\nGeneral setup\n  [*] Initial RAM filesystem and RAM disk (initramfs/initrd) support\n      CONFIG_BLK_DEV_INITRD=y\n\nDevice Drivers\n  Generic Driver Options\n    [*] Maintain a devtmpfs filesystem to mount at /dev\n        CONFIG_DEVTMPFS=y\n```\n\nFor encrypted root support, enable:\n\n```\nDevice Drivers ---\u003e\n  Multiple devices driver support (RAID and LVM) ---\u003e\n    [*] Device mapper support\n    [*] Crypt target support\n\nCryptographic API ---\u003e\n  \u003c*\u003e XTS support\n  \u003c*\u003e SHA224 and SHA256 digest algorithm\n  \u003c*\u003e AES cipher algorithms\n  \u003c*\u003e AES cipher algorithms (x86_64)\n  \u003c*\u003e User-space interface for hash algorithms\n  \u003c*\u003e User-space interface for symmetric key cipher algorithms\n```\n\nBuild-time\n----------\n  * POSIX `sh(1p)`, `make(1p)`, and \"mandatory utilities\"\n  * `scdoc(1)` to generate manual pages\n\nRuntime\n-------\n  * Any POSIX-compatible shell with `local` support\n  (e.g., `dash(1)`, Busybox `ash(1)`)\n  * GNU `getopt(1)`, `switch_root(8)`, `mount(8)`, `cpio(1)`\n\n**Optional runtime dependencies:**\n  * `ldd(1)` for copying binary dependencies\n  * `strip(1p)` for reducing image size by stripping binaries\n  * `blkid(8)` for UUID, LABEL, PARTUUID support\n  * `smdev` OR `mdev` OR `mdevd` OR `eudev` OR `systemd-udevd` or\n    `CONFIG_UEVENT_HELPER`\n  * `lvm(8)` for LVM support\n  * `cryptsetup(8)` for LUKS support\n  * Busybox `loadkmap` or kbd `loadkeys(8)` for keymap support\n  * `kmod(8)` OR Busybox modutils+[patch][1] for non-monolithic\n    kernels\n\n[1]: /patches/modprobe-kernel-version.patch\n\n---\n\nINSTALLATION\n============\n\nTo install:\n\n```sh\n# as root\nmake install\n```\n\nConfiguration parameters are defined in `config.mk`.\n\n---\n\nDOCUMENTATION\n=============\n\nBasic usage\n-----------\n\nConfigure `/etc/mkinitramfs/config` conform your needs (see\n`mkinitramfs.config(5)`).\n\nGenerate the initramfs:\n\n```sh\n# as root\nmkinitramfs -o \"/boot/initramfs-$(uname -r).img\"\n```\n\nUpdate your bootloader configuration (example for GRUB2):\n\n```sh\n# as root\ngrub-mkconfig -o /boot/grub/grub.cfg\n```\n\nReboot.\n\nOnline documentation\n--------------------\n\nProvided in `/man` and installed under the system manual hierarchy.\n\n---\n\nCREDITS\n=======\n\nOriginal developers:\n  * illiliti    \u003chttps://github.com/illiliti\u003e\n  * E5ten       \u003chttps://github.com/E5ten\u003e\n  * dylanaraps  \u003chttps://github.com/dylanaraps\u003e\n\nSupport the original author:\n  * illiliti / (BTC) 1BwrcsgtWZeLVvNeEQSg4A28a3yrGN3FpK\n  * https://patreon.com/illiliti\n\n---\n\nLICENSE\n=======\n\n`mkinitramfs` is licensed under the\n[GNU General Public License v3 or later](https://gnu.org/licenses/gpl.html).\n\nSee `COPYING` for license terms and `COPYRIGHT` for notices.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeppe-lin%2Fmkinitramfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzeppe-lin%2Fmkinitramfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeppe-lin%2Fmkinitramfs/lists"}