well-known branches

Branch Name	Description	Builds Against the Following Gluon Version	Used For
main		main	nightly builds, manual builds, (currently also) releases
next	currently not used yet	next	manual builds

prerequisites

• You need to have docker installed on your system.

build a current ffh gluon

# clone gluon
git clone https://github.com/freifunk-gluon/gluon
cd gluon
git checkout main

# clone site conf
git clone https://github.com/freifunkh/site

# apply site patches
git am site/patches/*

# if you want to test packages in ffh-packages, you
# need to adjust PACKAGES_HANNOVER_COMMIT to the
# lastest commit id in site/modules now
vi site/modules

# if you want to bump up the version number
vi site/site.mk

# Enter the container, which includes all build dependencies
./scripts/container.sh

# Obtain all "submodules" of gluon
make update

# List targets and pick your favorite one.
make list-targets

# maybe switch here to a screen session, if
# you are building on a remote system ;)

make -j $(nproc) GLUON_TARGET=ath79-generic

build all targets

TARGETS=$(make list-targets)

for t in $TARGETS; do
  make -j $(nproc) GLUON_TARGET=${t}
done

signing a firmware release

The firmware release must already be uploaded to the webserver on the correct path.

./ffh_sign.sh vH41~3

(If you haven't used this script before, it will guide you through it's setup steps.)

build for debugging purposes

• Debugging symbols are not stripped while building. (At least you still need to compile the package with -g to get the debug symbols, but they are not stripped)
• Packages gdb, valgrind and strace will be built in the image

make V=s GLUON_DEBUG=1 GLUON_TARGET=x86-generic &> logs/$(date -Is)_x86-generic.log