Updated docs
[citadel-docker.git] / Dockerfile
index 1426950ae8d25cb39eb66ccf87d83d07777ea330..0db03ed2618a30c6275289dd04a92f0dccfbe241 100644 (file)
@@ -1,4 +1,16 @@
 # Dockerfile for Citadel
+#
+# Copyright (c) 2019-2022 by the citadel.org team
+#
+# This program is open source software.  Use, duplication, or disclosure
+# is subject to the terms of the GNU General Public License, version 3.
+
+# This script implements a two stage build.  In the first stage we load in a full set of
+# development tools and build all of the components, including a version of Berkeley DB newer than
+# the one supplied in the repo.  Everything in /usr/local is copied into the second stage, which
+# is built with only runtime libraries to keep the image small.
+
+####################################################################################################
 
 # Debian Slim has all of the architectures we build on (amd64, i386, arm32)
 # The first stage build will bring in all of our development tools.
@@ -15,7 +27,7 @@ RUN apt -y update
 RUN apt -y install gcc bison make zlib1g-dev libldap2-dev libssl-dev gettext libical-dev libexpat1-dev curl libcurl4-openssl-dev git autoconf automake netbase libreadline-dev
 
 # Build our own local copy of Berkeley DB, because the one included with the system libs is too old.
-# For the container ... we're going to do static binaries because disk is cheap and the Gotards are doing it this way now too.
+# We will install it to /usr/local and carry it over to the second stage build.
 RUN sh -c 'mkdir /tmp/db_build && \
        cd /tmp/db_build && \
        curl -k https://easyinstall.citadel.org/db-6.2.32.NC.tar.gz | tar xvzf - && \
@@ -82,7 +94,7 @@ RUN sh -c '\
 
 ####################################################################################################
 
-# Second stage build is runtime only.
+# Second stage build only needs runtime libraries.
 FROM debian:bullseye-slim AS final-stage
 
 # All long term persistent data goes here.  Any volume driver may be used.