{"id":23099850,"url":"https://github.com/hempflower/firefly_init","last_synced_at":"2026-05-18T05:42:33.827Z","repository":{"id":265663739,"uuid":"896429300","full_name":"hempflower/firefly_init","owner":"hempflower","description":"Tiny init for MircoVM with useful features.","archived":false,"fork":false,"pushed_at":"2024-11-30T11:12:17.000Z","size":14,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-09T08:41:59.774Z","etag":null,"topics":["init","linux","microvm"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hempflower.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-11-30T10:42:48.000Z","updated_at":"2024-12-02T21:19:06.000Z","dependencies_parsed_at":"2024-11-30T12:28:20.422Z","dependency_job_id":null,"html_url":"https://github.com/hempflower/firefly_init","commit_stats":null,"previous_names":["hempflower/firefly_init"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hempflower%2Ffirefly_init","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hempflower%2Ffirefly_init/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hempflower%2Ffirefly_init/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hempflower%2Ffirefly_init/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hempflower","download_url":"https://codeload.github.com/hempflower/firefly_init/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247072989,"owners_count":20878976,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["init","linux","microvm"],"created_at":"2024-12-16T23:21:31.981Z","updated_at":"2025-11-04T12:02:00.609Z","avatar_url":"https://github.com/hempflower.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Firefly Init - MicroVM init\n\n## Introduction\n\nThis is a tiny init for MicroVMs. It can set hostname, dns, and run a entrypoint command like docker.\n\n## Build\n\nThis project is built with [Taskfile](https://taskfile.dev/). But you can also build it manually.\n\n### Taskfile\n\n```bash\ntask initramfs\n```\n\n### Manual Build\n\n```bash\nmkdir build\ncd firefly\nexport CGO_ENABLED=0\ngo build -o ../build/init . \n```\n\nthen create initramfs:\n\n```bash\nmkdir build/initramfs\ncp build/init build/initramfs/init\nchmod +x build/initramfs/init\nfind . | cpio -o -H newc \u003e ../initramfs.cpio\n```\n\n## Usage\n\nFireFly read commandline arguments from `/proc/cmdline`:\n\nfor example:\n\n```\nroot=/dev/vda ip=192.168.10.2/24:192.168.10.1 endpoint=/bin/bash\n```\n\n- `root` is the root device\n- `ip` is the static ip 192.168.10.2/24 with gateway 192.168.10.1\n- `endpoint` is the entrypoint command\n\n## Features\n\n- Set hostname\n- Set dns\n- Set static ip\n- Run entrypoint\n- Auto mount necessary filesystems such as /dev, /proc, /sys, etc\n- Shutdown VM if entrypoint exits\n\n## Supported Commandline Arguments\n\n- `hostname` is the hostname\n- `dns` is the dns server\n- `root` is the root device\n- `rootfstype` is the root filesystem type, default is `ext4`\n- `ip` is the static ip\n- `endpoint` is the entrypoint\n\n\n## Rescue Shell\n\nFirefly can run a rescue shell if something goes wrong. Such as cannot found root device, entrypoint not found...\n\nYou can add shell binary to `/bin/sh`, or run `task build-busybox` to add busybox to rootfs.\n\n## License\n\nMIT","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhempflower%2Ffirefly_init","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhempflower%2Ffirefly_init","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhempflower%2Ffirefly_init/lists"}