Apache Settings

The following settings files in the project codebase can be used to override default Apache settings.

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.test.docksal

	ProxyPass / http://docs.docksal.io/
	ProxyPassReverse / http://docs.docksal.io/

Using Different Apache Versions

When using the default stack (a custom project stack is not defined in .docksal/docksal.yml), switching can be done via the WEB_IMAGE variable in .docksal/docksal.env, e.g.:


This can also be set with fin config set.

fin config set WEB_IMAGE='docksal/web:2.1-apache2.2'

Remember to run fin project start (fin p start) to apply the configuration.

Available images:

  • Apache 2.2 - docksal/web:2.1-apache2.2
  • Apache 2.4 - docksal/web:2.1-apache2.4 (default)

There are also “edge” versions available that contain code from ongoing updates, but may not be stable. Don’t switch to an edge image unless directed to do so by the Docksal team for testing purposes only.

See documentation for projects using a custom stack configuration.