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

v1

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@v1

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

See action.yml

Parameters

  • profile: bcm27xx-bcm2711
  • openwrt-version: 22.03.2
  • packages: -ppp
  • files: test/files
  • disabled-services: dhcp
  • extra-image-name: useless

Outputs

  • ./bin/targets/**
    • e.g. ./bin/targets/bcm27xx/bcm2711/openwrt-22.03.2-useless-bcm27xx-bcm2711-rpi-4-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:
    profile: bcm27xx-bcm2711
    openwrt-version: 22.03.2
    packages: -ppp 

Add custom files

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

FAQ

How to find profile and openwrt-version

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

Additional Documentation

License

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