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

• .github/workflows/test.yml

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.

• bcm27xx-bcm2711-22.03.5
  • image: bcm27xx-bcm2711
  • openwrt-version: 22.03.5

Additional Documentation

• Run openwrt in Qemu

  https://gist.github.com/extremecoders-re/f2c4433d66c1d0864a157242b6d83f67

  https://fadeevab.com/how-to-setup-qemu-output-to-console-and-automate-using-shell-script/

License

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