{"id":26792959,"url":"https://github.com/osbuild/image-builder-action","last_synced_at":"2026-02-04T04:07:50.036Z","repository":{"id":277973407,"uuid":"934086537","full_name":"osbuild/image-builder-action","owner":"osbuild","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-17T09:19:28.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-02-17T10:26:43.579Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"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/osbuild.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":"2025-02-17T08:53:39.000Z","updated_at":"2025-02-17T09:58:54.000Z","dependencies_parsed_at":"2025-02-17T10:36:50.609Z","dependency_job_id":null,"html_url":"https://github.com/osbuild/image-builder-action","commit_stats":null,"previous_names":["osbuild/image-builder-action"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osbuild%2Fimage-builder-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osbuild%2Fimage-builder-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osbuild%2Fimage-builder-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osbuild%2Fimage-builder-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/osbuild","download_url":"https://codeload.github.com/osbuild/image-builder-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246207503,"owners_count":20740723,"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":"2025-03-29T16:18:18.990Z","updated_at":"2026-02-04T04:07:49.978Z","avatar_url":"https://github.com/osbuild.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Build OS images in GitHub Actions using [image-builder](https://github.com/osbuild/image-builder-cli)\n\nThis GitHub Action builds OS images using the [image-builder-cli](https://github.com/osbuild/image-builder-cli) container to build operating system artifacts (disk images, ISOs, etc.)\n\n## Prerequisites\n\n- Building images requires privileges, so make sure that you are not running the job triggering this action in [a container](https://docs.github.com/en/actions/writing-workflows/workflow-syntax-for-github-actions#jobsjob_idcontainer).\n- `podman` has to be installed (it is available on the hosted GitHub runners)\n\n## Inputs\n\nRun `podman run --rm --privileged ghcr.io/osbuild/image-builder-cli:latest list-images` to get the matrix of valid distributions and image types.\n\n- **distro** (string, required):\n  The Linux distribution version to build for. Example: `fedora-41`.\n\n- **image_type** (string, required):\n  The type of image to build. Example: `qcow2`.\n\n- **image_build_ref** (string, optional)\n  A reference to the image-builder container image to use for the build. Default: `ghcr.io/osbuild/image-builder-cli:latest`\n\n## Example Workflow\n\nBelow is an example of how you might use this action in a GitHub workflow:\n\n```yaml\nname: Build a Fedora 41 minimal raw image\n\non:\n  push:\n    branches: [ main ]\n  workflow_dispatch:\n\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Checkout Repository\n        uses: actions/checkout@v4\n\n      - name: Run Image Builder Action\n        uses: osbuild/image-builder-action@v1\n        with:\n          distro: fedora-41\n          image_type: minimal-raw\n\n      - name: Upload Build Artifact\n        uses: actions/upload-artifact@v4\n        with:\n          name: os-image\n          path: output/fedora-41-minimal-raw-x86_64/xz/disk.raw.xz\n```\n\n## Project\n\n * **Website**: https://www.osbuild.org\n * **Bug Tracker**: https://github.com/osbuild/image-builder-action/issues\n * **Discussions**: https://github.com/orgs/osbuild/discussions\n * **Matrix**: #image-builder on [fedoraproject.org](https://matrix.to/#/#image-builder:fedoraproject.org)\n\n## License\n\n - **Apache-2.0**\n - See LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosbuild%2Fimage-builder-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosbuild%2Fimage-builder-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosbuild%2Fimage-builder-action/lists"}