builds.rst 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. Builds
  2. ======
  3. For the build reserve 6GB of disk space. The building requires packages
  4. for ``subversion``, ncurses headers (``libncurses-dev``) and zlib headers
  5. (``libz-dev``).
  6. Building Gluon
  7. --------------
  8. To build Gluon, after checking out the repository change to the source root directory to perform the following commands:
  9. ::
  10. git clone git://github.com/freifunk-gluon/site-ffhl.git site # Get the Freifunk Lübeck site repository - or use your own!
  11. make update # Get other repositories used by Gluon
  12. make # Build Gluon
  13. When calling ``make``, the OpenWRT build environment is prepared and updated. To rebuild
  14. the images only, just use:
  15. ::
  16. make images
  17. The built images can be found in the directory ``images``.
  18. Cleaning up
  19. -----------
  20. There are three levels of ``make clean``:
  21. ::
  22. make clean
  23. will only clean the Gluon-specific files;
  24. ::
  25. make cleanall
  26. will also call ``make clean`` on the OpenWRT tree, and
  27. ::
  28. make dirclean
  29. will do all this, and call ``make dirclean`` on the OpenWRT tree.
  30. Environment variables
  31. ---------------------
  32. Gluon's build process can be controlled by various environment variables.
  33. GLUON_SITEDIR
  34. Path to the site configuration. Defaults to ``site/``.
  35. GLUON_IMAGEDIR
  36. Path where images will be stored. Defaults to ``images/``.
  37. GLUON_BUILDDIR
  38. Working directory during build. Defaults to ``build/``.