OpenWRT Build System is really huge, and takes a lot of time to build up things, so in order to make it easier to other Devs to use it, the Build System outputs two other build systems: the OpenWRT Package Builder and the OpenWRT Image/Firmware Builder.

OpenWRT Package Builder

The Package Builder allows developers to build up a specific set of packages without having to build the entire packaging system. So this means that the developers just need to plug-in their Package Feeds and set which packages are meant to be built.

### OpenWRT Image/Firmware Builder

The Image Builder allows developers to build an Image/Firmware to deploy on their devices without having to build all the packages from scratch. This allows Continuous Delivery systems to be much more eficient since it is just installing packages into lean file-systems.

Why?

This project was developed this because of disadvantages found on legacy ones:

Setup - It takes some time to setup, and on Docker-based CI environments, if things aren't cleared properly, error are introduced between build iterations.
Disk usage - A full setup for a target takes a lot of space. It's much more efficient to have a setup where there are ephemeral changes between build iterations, assuming caching of the initial setup, which can be achieved using docker.

## Architecture

### Base image cusspvz/openwrt-builder:base

There is a base image from where all the other images are based. This image is based on Debian and includes all the tools needed for the OpenWRT Builders.

### OpenWRT Package Builder cusspvz/openwrt-builder:package-builder_VERSION_TARGET[_SUBTARGET]

Examples: cusspvz/openwrt-builder:package-builder_18.0.1_brcm2708-bcm2710 Examples: cusspvz/openwrt-builder:package-builder_17.01.6_brcm2708-bcm2710

### OpenWRT Image/Firmware Builder cusspvz/openwrt-builder:image-builder_VERSION_TARGET[_SUBTARGET]

Examples: cusspvz/openwrt-builder:image-builder_18.0.1_brcm2708-bcm2710 Examples: cusspvz/openwrt-builder:image-builder_17.01.6_brcm2708-bcm2710

#### Docker Container folders: /src - Builder Source /feeds - folder to link custom feeds. The image detects mounted folders automatically, so there's no need to tell which feeds you want to build. /overlay - folder with files and folders to overlay on the images root /output - folder to output built images

Usage

### OpenWRT Package Builder

Builds .opkg files and a Packages.gz


docker run -ti --rm \
    -e PACKAGES="transmission openvpn node node-npm" \
    -v /path/to/custom-packages-feed:/feeds/mypackages:z \
    -v /path/to/output-dir:/output:z \
    cusspvz/openwrt-builder:package-builder_18.0.1_brcm2708-bcm2710

### OpenWRT Image/Firmware Builder

Builds all the target images.


docker run -ti --rm \
    -e PACKAGES="-luci transmission openvpn node node-npm" \
    -e CUSTOM_FEEDS="mypackages" \
    -v /path/to/custom-packages-feed:/feeds/mypackages:z \
    -v /path/to/overlay-dir:/overlay:z \
    -v /path/to/output-dir:/output:z \
    cusspvz/openwrt-builder:image-builder_18.0.1_brcm2708-bcm2710

Donate

Want to buy me a cup of coffee?

BTC: 3FyTUneEqXrpRyCjmXvH4kdmvg7Tomwc4j LTC: MFyux9RBvgjy79iQDgtegYMkJbUqiC27i7 ETH: 0xa2b5Be27d03916E48Ae445A48d784B0E3cBD825a ETC: 0xC4b531135a381d2A91F718249eb33a90f187B231 BTC-CASH: LOL

Thanks

Credits

Thanks to jandelgado for his work on the docker builder and the docker compiler.

This exists thanks to:

@OpenWRT team on OpenWRT
@jandelgado on lede-dockercompiler
@jandelgado on lede-dockerbuilder

README.md

OpenWRT Docker Builder

What does it do?

OpenWRT Package Builder

Why?

Usage

Donate

Credits

License