appimage/README.txt

   1 ****************************************************************************************
   2 **  DO NOT RUN THE APPIMAGE BUILD ON A PRODUCTION MACHINE!  IT WILL ERASE YOUR DATA!  **
   3 ****************************************************************************************
   4
   5 The tooling in this directory can be used to build an AppImage, the entire Citadel System
   6 distributed as a single binary file.  Visit https://appimage.org/ to learn more about the
   7 AppImage format and how it works.
   8
   9 Again, do NOT try to build this on your production machine.  For that matter, don't try
  10 to build it on anything other than a dedicated build host.  It may ERASE data you
  11 intended to keep.
  12
  13 If you're an end user you shouldn't have any need to do this at all.  The whole point of
  14 this is that we can supply ready-to-run binaries that will run on any Linux/Linux system
  15 without modification or dependencies.  If you are an end user, stop here, go download the
  16 binary package, and use it.  Enjoy it and have fun.
  17
  18 Still with us?  Then you must be a new member of the build team.  So here's what you have
  19 to do to build the binary:
  20
  21 1. Download the Citadel source tree (if you're reading this, you've already done that).
  22 2. Install all system dependencies.  The same ones needed for Easy Install are fine.
  23 3. Download and install "appimagetool" from appimage.org.
  24 4. Run "./build_appimage.sh"
  25
  26 What's going to happen next?
  27
  28 1. Any existing /usr/local/citadel and /usr/local/webcit will be erased.
  29 2. The script will go through the source tree, building and installing libcitadel,
  30    the Citadel server, and WebCit into the /usr/local hierarchy.
  31 3. All binaries, static data, and libraries will be copied into the citadel.AppDir
  32    tree.
  33 4. appimagetool will be called, and it will generate an executable with a
  34    name like "Citadel-x64.AppImage".   This is your distributable binary.  Upload
  35    it somewhere fun.
  36
  37 You should be running this build on the OLDEST version of Linux/Linux on which your
  38 binary should be able to run.  The distribution does not matter -- for example, a
  39 binary built on Debian should run fine on Ubuntu or Red Hat or whatever -- but the C
  40 library and other very base system libraries are only upward compatible, not downward
  41 compatible.  For example, at the time of this writing, I am building on Ubuntu 16 and
  42 it's early 2021.