Skip to main content
Example Repo

​
Adding Apache to your Shell​

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

​
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/apacheHttpd/httpd.conf.

​
Environment Variables​

HTTPD_ACCESS_LOG_FILE={PROJECT_DIR}/.devbox/virtenv/apacheHttpd/access.logHTTPD_ERROR_LOG_FILE={PROJECT_DIR}/.devbox/virtenv/apacheHttpd/error.logHTTPD_PORT=8080HTTPD_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.

​
Disabling the Apache Plugin​

You can disable the Apache plugin by running devbox add apache --disable-plugin, or by setting the disable_plugin field in your devbox.json: 
{
  "packages": {
    "apache": {
      "version": "latest",
      "disable_plugin": true
    }
  }
}
Edit this page
⌘I