laineil/httpd repository overview

⁠About Apache HTTPD

The Apache HTTP Server Project⁠ is an effort to develop and maintain an open-source HTTP server for modern operating systems including UNIX and Windows. The goal of this project is to provide a secure, efficient and extensible server that provides HTTP services in sync with the current HTTP standards.

• Apache Module mod_ssl⁠
  • This module provides SSL v3 and TLS v1.x support for the Apache HTTP Server. SSL v2 is no longer supported.
  • This module relies on OpenSSL⁠ to provide the cryptography engine.
  • Further details, discussion, and examples are provided in the SSL documentation⁠.

⁠Image information

• The use of non-root container images can enhance system security.
• Support the TZ environment variable to set up the desired timezone (see Services top-level element⁠).
• Base on Apache HTTPD versions supported by Red Hat⁠.
• By default, a self-signed TLS certificate is supplied.
• Subscribe to project updates by watching the laineil/containers GitHub repo⁠ for more information.

⁠Configuration

The container can be easily setup with the following environment variables:

• HTTPD_LOG_LEVEL: Set the log level for the apache httpd server (see LogLevel Directive⁠ for possible values). Default: warn
• HTTPD_TLS_ROOTCA: Whether to enable rootca for TLS or not. Default: disable
  • enable:
    • Supply a self-signed TLS certificate (with CA). You can replace the certificate with your own.
    • certs dir: /opt/certs
    • certs files: rootca.crt, server.crt, server.key

To customize the configuration of the httpd server, you can obtain the upstream default configuration from the container:

• httpd.conf

$ docker run --rm --entrypoint '' laineil/httpd:[tag] cat /etc/httpd/conf/httpd.conf > custom_httpd.conf

• ssl.conf

$ docker run --rm --entrypoint '' laineil/httpd:[tag] cat /etc/httpd/conf.d/ssl.conf > custom_ssl.conf

⁠Run a container

Here are a few methods for running a container.

• Quick start (Recommended)

$ docker run -d \
--name httpd_app \
-v [ext_html_dir]:/var/www/html/[int_html_dir] \
-p [expose_port]:8080 \
-p [expose_port]:8443 \
laineil/httpd:[tag]

# Make sure the owner uid of [ext_html_dir] is 1000.

• With your own TLS certificate with CA

$ docker run -d \
--name httpd_app \
-v [ext_html_dir]:/var/www/html/[int_html_dir] \
-v [certs_path]:/opt/certs:ro \
-p [expose_port]:8080 \
-p [expose_port]:8443 \
-e HTTPD_TLS_ROOTCA=enable \
laineil/httpd:[tag]

# [certs_folder] must contains rootca.crt, server.crt, server.key (certificate name must match).
# Make sure the certificate files within [certs_folder] have permission 644.

• With customeize conf

$ docker run -d \
--name httpd_app \
-v custom_httpd.conf:/etc/httpd/conf/httpd.conf \
-v custom_ssl.conf:/etc/httpd/conf.d/ssl.conf \
-p [expose_port]:8080 \
-p [expose_port]:8443 \
laineil/httpd:[tag]

# Make sure the permission of conf files is 644.

⁠Verify

• with http
  • http://[server_host]:[expose_port]/[int_html_dir]
• with https
  • https://[server_host]:[expose_port]/[int_html_dir]

⁠Logging

$ docker logs httpd_app

⁠Remove

• Stop container

$ docker container stop httpd_app

• Remove container

$ docker container rm httpd_app

⁠License Agreement

BSD 3-Clause License
Copyright (c) 2023, Laineil
All rights reserved.