Skip to content
Snippets Groups Projects
Select Git revision
  • f0210846db8a6b9a6fee6dd3344671ea474f2567
  • v2018.2.x default protected
  • 0x4A6F-rpi4
  • 0x4A6F-master
  • master
  • v2018.2.2-ffs
  • v2016.2.4-batmanbug
  • radv-filterd
  • v2016.2.x
  • hoodselector
  • v2016.1.x
  • babel
  • v2015.1.x
  • 2014.4.x
  • 2014.3.x
  • v2018.2.2-ffs0.1
  • v2018.2.1-ffs0.1
  • v2018.2.1
  • v2018.2-ffs0.1
  • v2018.2
  • v2018.1.4
  • v2018.1.3
  • v2018.1.2
  • v2018.1.1
  • v2018.1
  • v2017.1.8
  • v2017.1.7
  • v2017.1.6
  • v2017.1.5
  • v2017.1.4
  • v2017.1.3
  • v2017.1.2
  • v2016.2.7
  • v2017.1.1
  • v2017.1
35 results

getting_started.rst

Blame
    • Forked from firmware / FFS Gluon
    5016 commits behind the upstream repository.
    getting_started.rst 2.48 KiB

    Getting Started

    Selecting the right version

    The versions of gluon are managed with tags and branches. Every tag is a stable release (like v2014.2 or v2014.3.1), every branch is a development branch, where 2014.3.x is a branch for 2014.3 bugfix releases and master is the unstable branch for the upcoming release. Branches should be used for development purposes, while tags can be used for productive releases. To check out a tag do:

    git clone https://github.com/freifunk-gluon/gluon.git gluon
cd gluon
git checkout v2014.3

    Please keep in mind that you need the appropriate site configuration for that gluon version.

    Building the image

    To build Gluon, after checking out the repository change to the source root directory as shown above and perform the following commands:

    git clone git://github.com/freifunk-gluon/site-ffhl.git site # Get the Freifunk Lübeck site repository - or use your own!
make update                                                  # Get other repositories used by Gluon
make                                                         # Build Gluon

    When calling make, the OpenWRT build environment is prepared/updated. To rebuild the images only, just use:

    make images

    The built images can be found in the directory images. Of these, the factory images are to be used when flashing from the original firmware a device came with, and sysupgrade is to upgrade from other versions of Gluon or any other OpenWRT-based system.

    For the build reserve 6GB of disk space. The build requires packages for subversion, ncurses headers (libncurses-dev) and zlib headers (libz-dev).

    There are two levels of make clean:

    make clean

    will ensure all packages are rebuilt; this is what you normally want to do after an update.

    make dirclean

    will clean the entire tree, so the toolchain will be rebuilt as well, which is not necessary in most cases, and will take a while.

    Environment variables

    Gluon's build process can be controlled by various environment variables.

    GLUON_SITEDIR
    Path to the site configuration. Defaults to site/.
    GLUON_IMAGEDIR
    Path where images will be stored. Defaults to images/.
    GLUON_BUILDDIR
    Working directory during build. Defaults to build/.

    So all in all, to update and rebuild a Gluon build tree, the following commands should be used:

    git pull
(cd site && git pull)
make update
make clean
make

    Impressum - Datenschutz