I recently saw someone on Slack asking for some guidance on how to set up Apache to work with CommandBox. There are a few reasons why someone might want to do this:

• It's a good way to terminate an SSL without CommandBox worrying about it
• Handling web requests is what Apache (and nginx, for that matter) is best suited to do
• There are some opportunities to use a load balancer or traffic filtering device

Surely there are other reasons, but that's not what this post is about.

Before you get too much further, make sure mod_proxy is enabled in Apache. There are existing resources for how to do this in whichever setup you have so I won't cover it here. This article also doesn't cover securing the server or any other Apache configuration; I'll leave that to you.

Now... for the reason you're here!

<VirtualHost *:80>
    ServerName myserver.test
    Protocols h2 h2c http/1.1

    ProxyRequests off
    ProxyPass / http://127.0.0.1:12345
    ProxyPassReverse / http://127.0.0.1:12345

    # Optional rewrite rules to redirect to https could go here
</VirtualHost>

If you're going to use this Gist, be sure to replace a few pieces of information:

1. Replace myserver.test with the name of your server
2. In the proxy lines where you see 12345, replace that with the port CommandBox uses
3. If you configured CommandBox to run on an IP other than 127.0.0.1, be sure to update that as well
4. If you don't want to support HTTP/2, you can remove the line starting with Protocols

ProxyPass & ProxyPassReverse are the magic lines you need to tell Apache to take requests served by this VirtualHost and pass them along to CommandBox.