Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
box

GitHub Action

OpenWrt ImageBuilder

v5

OpenWrt ImageBuilder

box

OpenWrt ImageBuilder

Build OpenWrt custom images using ImageBuilder - https://openwrt.org/docs/guide-user/additional-software/imagebuilder

Installation

Copy and paste the following snippet into your .yml file.

              

- name: OpenWrt ImageBuilder

uses: izer-xyz/openwrt-imagebuilder-action@v5

Learn more about this action in izer-xyz/openwrt-imagebuilder-action

Choose a version

openwrt-imagebuilder-action

Build and OpenWrt firmware image using Imagebuilder.

Usage

Use template repo: openwrt-imagebuilder-action-template

See action.yml from more details.

Parameters

  • image: bcm27xx-bcm2711
  • profile: Default
  • openwrt-version: 22.03.5
  • packages: -ppp
  • files: test/files
  • disabled-services: dhcp

Outputs

  • ./bin/*
    • e.g. ./bin/squashfs-factory.img.gz

An example workflow creating a very basic (packages removed; custom files added) image and then running with Qemu

Build a firmware image without ppp package

steps:
- uses: izer-xyz/openwrt-imagebuilder-action@v1
  with:
    image: bcm27xx-bcm2711
    openwrt-version: 22.03.5
    packages: -ppp 

Add custom files

steps:
- uses: izer-xyz/openwrt-imagebuilder-action@v1
  with:
    image: bcm27xx-bcm2711
    openwrt-version: 22.03.5
    files: test/files

FAQ

How to find image and openwrt-version

The Docker Hub Imagebuilder tags are formatted ${image}-${openwrt-version}. E.g.

Additional Documentation

License

The scripts and documentation in this project are released under the MIT License.