Skip to main content

Apache

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 apacheHttpd

Example Repo

Open In Devbox.sh

Adding Apache to your Shell​

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

  "packages": [
    "apacheHttpd"
  ]

Apache Plugin Details​

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

Services​

  • apache

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

Helper Files​

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/Apache/Apache.conf

Environment Variables​

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

Notes​

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