{"id":19196054,"url":"https://github.com/acj/freebsd-firecracker","last_synced_at":"2026-03-18T00:04:46.515Z","repository":{"id":208742179,"uuid":"722380180","full_name":"acj/freebsd-firecracker","owner":"acj","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-15T01:13:16.000Z","size":32,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-15T02:24:37.193Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/acj.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":"2023-11-23T02:48:36.000Z","updated_at":"2024-12-09T12:29:18.000Z","dependencies_parsed_at":"2023-12-06T01:28:06.678Z","dependency_job_id":"bff9891a-c896-448c-85ed-6bfb48307267","html_url":"https://github.com/acj/freebsd-firecracker","commit_stats":null,"previous_names":["acj/freebsd-firecracker"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acj%2Ffreebsd-firecracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acj%2Ffreebsd-firecracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acj%2Ffreebsd-firecracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acj%2Ffreebsd-firecracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/acj","download_url":"https://codeload.github.com/acj/freebsd-firecracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253171166,"owners_count":21865275,"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":[],"created_at":"2024-11-09T12:12:24.614Z","updated_at":"2026-03-18T00:04:46.508Z","avatar_url":"https://github.com/acj.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Run FreeBSD in a Firecracker VM\n\nThis repository contains the scripts and patches needed to boot FreeBSD inside of a Firecracker VM, with an eye towards running FreeBSD in GitHub Actions. My motivating use case is to quickly launch FreeBSD VMs in [rbspy](https://github.com/rbspy/rbspy) CI, which used to be slow and unreliable.\n\n## How it works\n\nTo bootstrap the kernel and rootfs images, the CI workflow launches a FreeBSD VM using Vagrant and QEMU. We apply a small patch to the kernel to make it bootable on the AMD Epyc CPUs that GitHub Actions uses in its runners. The kernel and rootfs are then copied out of the VM and published as artifacts.\n\n## Getting started\n\nIf you want to run FreeBSD in GitHub Actions, please have a look at [freebsd-firecracker-action](https://github.com/acj/freebsd-firecracker-action).\n\nYou probably won't need to use this repository directly unless you need to make changes to the base image.\n\n## Current status\n\n- [X] Supports FreeBSD 15.0-RELEASE and Firecracker 1.15.0\n- [X] Supports Intel and AMD CPUs\n- [X] Boots \\~instantly in GitHub Actions, excluding download and configuration time\n\n## Limitations\n\n- FreeBSD 14+ because we need recent Firecracker-related changes\n- Does not boot on Intel CPUs with `vcpu_count` \u003e1 but works fine if the VM is configured to use a single vCPU\n\n## Contributing\n\nPlease be kind. We're all trying to do our best.\n\nIf you're having trouble and are confident that it's related to the base images, then please open\nan issue. If you'd like to suggest an improvement, please open a PR.\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facj%2Ffreebsd-firecracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Facj%2Ffreebsd-firecracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facj%2Ffreebsd-firecracker/lists"}