Skip to content

Latest commit

 

History

History
43 lines (26 loc) · 2.43 KB

apache-web-server.md

File metadata and controls

43 lines (26 loc) · 2.43 KB
Raw

Apache

We use the official Apache image and apply some light customisations on top (ie. enabling modules).

<folder>.localhost is not working

Double-check your Docker Dev containers are running.

Most browsers (eg. Google Chrome, Microsoft Edge) will automatically detect the .localhost TLD and connect to your local web server. However, if you are receiving an error it could be because your browser is not doing this.

We recommend manually adding those domains to your hosts file. eg:

127.0.0.1   mysite.php83.pub.localhost

How do I use HTTPS/SSL for my local containers?

HTTPS (port 443) is enabled by default, however Apache is using a self-signed certficate which your browser may reject. You might need to enable a feature flag:

  • edge://flags or chrome://flags or brave://flags...
  • Enable: Allow invalid certificates for resources loaded from localhost.

Using custom hostnames for local sites

You can set up your Docker Dev environment to handle requests for the real/prod domains. This can be very useful for sites that use OAuth connections, like Google and Xero.

Obviously this is only useful for testing OAuth on your local device. It is not suitable for receiving webhooks or sharing the project with others.

  1. Browse the apache/sites/localhost/ or apache/sites/pub.localhost/ folders and choose a config that matches your needs the best (eg. PHP version, "public" folder)
  2. Copy that config file and save it to apache/sites/acme-corp.conf.
    • NOTE: The folder location and .conf file extension is important, but the name itself can be whatever you want.
  3. Edit your new config:
    1. Edit ServerName and type in the actual hostname you want to use. Eg. ServerName acme-corp.com
    2. Delete the ServerAlias lines
    3. Edit the VirtualDocumentRoot lines and swap %1 for your project's folder name (eg. acme-corp). You should end up with a fully formed absolute folder path like VirtualDocumentRoot /var/www/html/acme-corp/public
  4. Restart Apache: docker compose restart apache (run this while inside the docker-dev project folder)
  5. Edit your hosts file and point your domain to 127.0.0.1

Note that apache will load the conf files in alphabetical order. Because our localhost.conf has a "catch all", any of our custom conf files, must be named alphabetically before localhost.conf