starttoaster/apaxyalps repository overview

⁠docker-apaxy

A simple configurable container to generate an Apache docker container with Apaxy⁠. Thanks to Adam Whitcroft for creating, maintaining, and sharing the Apaxy project⁠. Special thanks as well to Xetus OSS for the creation of this Docker image source, to which my changes were rather minor.

⁠Examples

⁠Quick Start

Run the following:

docker run -d \
 --name apaxy \
 -v /your/file/share/directory:/data \
 -p 80:80 \
 starttoaster/apaxyalps

Add files to /your/file/share/directory/webroot on your Docker host to see them populate in the Apaxy-style Apache file index running in the new container.

⁠Apaxy Configuration

To override the default header, footer, and css provided out-of-the-box with Apaxy:

docker run -d \
 --name apaxy \
 -v /your/file/share/directory:/data \
 -p 80:80 \
 -e APAXY_HEADER=/data/header-override.html \
 -e APAXY_FOOTER=/data/footer-override.html \
 -e APAXY_CSS=/data/style-override.css \
 starttoaster/apaxyalps

⁠Details

The container exposes a data volume at /data. The following directories are added by default once the container starts up if they don't already exist:

# The document root for the Apache server. If the 
# APAXY_CONTEXT_PATH option is specified, the path
# will be generated as a subdirectory to this webroot
# folder if it does not already exist.
/data/webroot

# The location of the Apaxy error log
/data/log

# The directory out of which the Apaxy theme files are served.
# Note that this will not be generated if it exists when the container 
# is started
/data/apaxy_theme

⁠Configuration

The following environment variable configurations are available:

• APAXY_CONTEXT_PATH: The context path from which the Apaxy file index should be configured. Defaults to no context path (the Apaxy file index is configured at the root ('/') endpoint).
• APAXY_HEADER: The path to a custom Apaxy header.html file with which to override Apaxy's default header. Please see the Apaxy source for the header's requirements.
• APAXY_FOOTER: The path to a custom Apaxy footer.html file with which to override Apaxy's default footer. Please see the Apaxy source for the footer's requirements.
• APAXY_CSS: The path to a CSS file that should be used instead of the default Apaxy CSS file.

⁠Credits

Thanks again to Adam Whitcroft for creating, maintaining, and sharing the Apaxy project⁠. As well as Xetus OSS⁠ for creating the base for this Docker repo.