runtime/faq/apache config

From JumpBox Documentation Wiki

Jump to: navigation, search

Where are the Apache configuration files?

The Apache webserver configuration files are in /etc/apache2/, they are split out into several files in a way that is common to the Debian and Ubuntu Linux distributions. The highlights of these files and directories are as follows

  • /etc/apache2/apache2.conf - The main configuration file, you can see where it includes the other files
  • /etc/apache2/conf.d - auxiliary configuration, used by some applications, not currently used by JumpBox
  • /etc/apache2/mods-* - directories related to apache module loading and configuration
  • /etc/apache2/sites-available - definitions of apache sites
  • /etc/apache2/sites-enabled - sites in sites-available are linked into this directory to enable them
  • /etc/apache2/ssl - ssl related configuration

There are JumpBox specific apache configuration files in /jumpbox/etc/apache2, these are included by the sites defined in /etc/apache2/sites-available

  • /jumpbox/etc/apache2/jumpbox-app - The application specific apache configuration
  • /jumpbox/etc/apache2/jumpbox-app-ssl - The application specific apache configuration used if SSL enabled, though its typically the same
  • /jumpbox/etc/apache2/jumpbox-common - The apache configuration that is common between the JumpBox applications

A little more discussion of the entries under /etc/apache2/sites-available is useful. The files that begin with default.* are vhost definitions for the application on port 80, default-ssl.* are for the application on port 443. These are not enabled simultaneously, but are managed by the JumpBox admin portal based on the SSL setting.

  • default.off - Application site (port 80) configuration, with SSL disabled.
  • default.auto - Application site (port 80) configuration with auto generated certificate.
  • default.custom - Application site (port 80) configuration with custom certificate.
  • default-ssl.off - Application SSL site (port 443) configuration, with SSL disabled.
  • default-ssl.auto - Application SSL site (port 443) configuration, with SSL enabled, with the auto generated certificate.
  • default-ssl.custom - Application SSL site (port 443) configuration, with SSL enabled, with the custom certificate.
  • jumpbox-admin - JumpBox Admin portal site definition, does not change, has SSL enabled.

To see which of the vhost definitions is in use you can just list the contents of the sites-enabled directory:

 ls -l /etc/apache2/sites-enabled/
Views
Personal tools