Apache can be automatically configured by Devbox via the built-in Apache Plugin. This plugin will activate automatically when you install Apache using devbox add apache.

Example Repo

Run devbox add apache, or add the following to your devbox.json

  "packages": [
    "apache@latest"
  ]

This will install the latest version of Apache. You can find other installable versions of Apache by running devbox search apache. You can also view the available versions on Nixhub

The Apache plugin will automatically create the following configuration when you install Apache with devbox add.

• apache

Use devbox services start|stop apache to start and stop httpd in the background.

The following helper files will be created in your project directory:

• {PROJECT_DIR}/devbox.d/apacheHttpd/httpd.conf
• {PROJECT_DIR}/devbox.d/web/index.html

Note that by default, Apache is configured with ./devbox.d/web as the DocumentRoot. To change this, you should copy and modify the default ./devbox.d/apacheHttpd/httpd.conf.

HTTPD_ACCESS_LOG_FILE={PROJECT_DIR}/.devbox/virtenv/apacheHttpd/access.log
HTTPD_ERROR_LOG_FILE={PROJECT_DIR}/.devbox/virtenv/apacheHttpd/error.log
HTTPD_PORT=8080
HTTPD_DEVBOX_CONFIG_DIR={PROJECT_DIR}
HTTPD_CONFDIR={PROJECT_DIR}/devbox.d/apacheHttpd

We recommend copying your httpd.conf file to a new directory and updating HTTPD_CONFDIR if you decide to modify it.