For this guide, we’ll refer to apache/httpd.  If you’re running nginx or openlitespeed, the guide still applies, but changes in the template names may apply.  More on the different names in this guide.

nginx Updating, recompiling, VirtualHost templates, customizations, php safemode …CUSTOM HTTPD TEMPLATES: read order

Knowing the order in which all of the templates are being loaded in help determine when your tokens will be available.

1. Loaded once before each VirtualHost is added:

   CUSTOM_DOMAIN_ITEM_*

2. WEBSERVER, DOMAIN, HAVE_SAFE_MODE, SSL_TEMPLATE, SPACE_HTTP2, IP, PROXY_IP, HAVE_NGINX_PROXY, PORT_8080, PORT_8081, PROXY_BUFFERING,
   LISTENERS, IF_MODULE_LITESPEED_OPEN, IF_MODULE_LITESPEED_OPEN, IF_MODULE_LITESPEED_CLOSE, IP1|2.., MULTI_IP, HOME, USERHOME, PACKAGE,
   REALUSER, ADMIN, CERT, KEY, HOSTNAME, SAFE_MODE, OPEN_BASEDIR, OPEN_BASEDIR_ENABLED, PHP_MAIL_LOG_ENABLED, CREATOR, BANDWIDTH, QUOTA,
   PORT_80, PORT_443, APACHELOGDIR

3. CB_VERSION, PHP1_RELEASE, PHP2_RELEASE, LSPHP1_RELEASE, LSPHP2_RELEASE, HAVE_PHP1_FPM, HAVE_PHP2_FPM, HAVE_PHP1_FCGI, HAVE_PHP2_FCGI,
   HAVE_PHP_FCGI, HAVE_RUID2, HAVE_MOD_SECURITY, HAVE_USERDIR_ACCESS, RUID2_AND_MOD_SECURITY,
   (MODSEC_AUDIT_DIR, NGINX_MOD_SECURITY_ENABLE)|NGINX_MOD_SECURITY_ENABLE, USE_HOSTNAME_FOR_ALIAS, HAVE_SUEXEC_PER_DIR, SUSPENDED_REASON,
   CLI, HAVE_PHP1_CLI, HAVE_PHP2_CLI, SUPHP, HAVE_PHP1_SUPHP, HAVE_PHP2_SUPHP, USECANONICALNAME, CAROOT, SERVER_ALIASES

4. HANDLERS, MIMETYPES, USER, GROUP, SECURE_ACCESS_GROUP, (OLS)SSLPROTOCOL, SDOCROOT, SUSPENDED, CGI, PHP, SUB, FORCE_SSL_REDIRECT

5. Tokens TOK=value, not templates:

   /usr/local/directadmin/data/admin/global_httpd_tokens.conf
   /usr/local/directadmin/data/users/fred/user.httpd_tokens
   /usr/local/directadmin/data/users/fred/domains/domain.com.httpd_tokens
   /usr/local/directadmin/data/users/fred/domains/domain.com.sub.httpd_tokens

6. VirtualHost pre, where virtual_host2.conf would be whichever template file is used for this VH. Fully tokenized template.

   /usr/local/directadmin/data/templates/custom/virtual_host2.conf.pre

7. /usr/local/directadmin/data/templates/cust_httpd.CUSTOM.pre
   /usr/local/directadmin/data/templates/custom/virtual_host2.conf.CUSTOM.pre
   /usr/local/directadmin/data/users/fred/domains/domain.com.cust_httpd
   /usr/local/directadmin/data/templates/custom/virtual_host2.conf.CUSTOM.post
   /usr/local/directadmin/data/templates/cust_httpd.CUSTOM.post

   added to CUSTOM.

8. For each custom token, 1 through 8 (we’ll use 1 for the example):

   /usr/local/directadmin/data/templates/custom/virtual_host2.conf.CUSTOM.1.pre
   /usr/local/directadmin/data/templates/custom/cust_httpd.CUSTOM.1.pre
   /usr/local/directadmin/data/users/fred/domains/domain.com.cust_httpd.CUSTOM.1
   /usr/local/directadmin/data/templates/custom/cust_httpd.CUSTOM.1.post
   /usr/local/directadmin/data/templates/custom/virtual_host2.conf.CUSTOM.1.post

   added to CUSTOM1

9. PROTECTED_DIRECTORIES, CONTEXTS, REALMS, NGINX_REDIRECTS, OPENLITESPEED_REDIRECTS, HOTLINK_PROTECTION, EXTRA_LOCATIONS, LOCATION_INSERT, NGINX_PHP_CONF

10. if exists: /usr/local/directadmin/data/templates/custom/virtual_host2.conf
    else: /usr/local/directadmin/data/templates/custom/virtual_host2.conf

nginx [engine x] is an HTTP and reverse proxy server, a mail proxy server, and a generic TCP/UDP proxy server, originally written by Igor Sysoev.

For a long time, it has been running on many heavily loaded Russian sites including Yandex, Mail.Ru, VK, and Rambler. According to Netcraft, nginx served or proxied 25.65% busiest sites in March 2020. Here are some of the success stories: Dropbox, Netflix, WordPress.com, FastMail.FM.

The sources and documentation are distributed under the 2-clause BSD-like license.

Commercial support is available from Nginx, Inc.