Skip to content

Latest commit

 

History

History
59 lines (39 loc) · 1.45 KB

README.md

File metadata and controls

59 lines (39 loc) · 1.45 KB

Apache Docker images for Docksal

This image(s) is part of the Docksal image library.

Versions

  • apache2.4 (based on http:2.4-alpine)

Features

  • SSL enabled (self-signed cert)
  • PHP handling via FastCGI (mod_proxy_fcgi)
  • HTTP Basic Authentication
  • Support for configuration overrides

Document root

Apache DocumentRoot for the default virtual host can be set via APACHE_DOCUMENTROOTenvironment variable (defaults to /var/www/docroot).

FastCGI server endpoint

These images are set up to work with a FastCGI server and will not start without one.
The FastCGI endpoint can be set via APACHE_FCGI_HOST_PORT environment variable (defaults to cli:9000).

HTTP Basic Authentication

Use APACHE_BASIC_AUTH_USER and APACHE_BASIC_AUTH_PASS environment variables to set username and password.

Example with Docker Compose

  ...
  environment:
    - APACHE_BASIC_AUTH_USER=user
    - APACHE_BASIC_AUTH_PASS=password
  ...

Configuration overrides

Configuration overrides can be added to a Docksal project codebase.

Use .docksal/etc/apache/httpd-vhost-overrides.conf to override the default virtual host configuration:

DirectoryIndex index2.html

Use .docksal/etc/apache/httpd-vhosts.conf to define additional virtual hosts:

<VirtualHost *:80>
	ServerName docs.docksal.site

	ProxyPass / http://docs.docksal.io/
	ProxyPassReverse / http://docs.docksal.io/
</VirtualHost>