Synchronet v3.21e-Win32 (install) has been released (Mar-2026).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
server:web [2026/02/12 02:01] – Put the Options in a table digital manserver:web [2026/03/04 13:51] (current) – [Reference] mention letsyncrypt nelgin
Line 89: Line 89:
 | OutbufDrainTimeout       | ''10''           | Number of milliseconds to wait for output buffer to drain | | OutbufDrainTimeout       | ''10''           | Number of milliseconds to wait for output buffer to drain |
 | TempDirectory            | ''../temp/''     | Override default temporary file directory | | TempDirectory            | ''../temp/''     | Override default temporary file directory |
 +| LoginRequirements        | [global]         | [[:Access:]] [[:access:requirements]] (in ARS format) for users to be allowed login |
 | LoginAttempt*            | [global]         | Failed login attempt throttling / filtering / banning | | LoginAttempt*            | [global]         | Failed login attempt throttling / filtering / banning |
 | LoginInfoSave            |                  | An optional [[access:requirements|ARS]] that can be used to limit which users will have their login details saved to the userbase | | LoginInfoSave            |                  | An optional [[access:requirements|ARS]] that can be used to limit which users will have their login details saved to the userbase |
Line 117: Line 118:
 | DEBUG_SSJS    | Log server-side JavaScript execution details. | | DEBUG_SSJS    | Log server-side JavaScript execution details. |
  
-== VIRTUAL_HOSTS ==+==== Reference ==== 
 + 
 +Web Server configuration settings reference: 
 +  
 +=== Virtual Hosts ===
  
 If your system has multiple If your system has multiple
Line 141: Line 146:
 </code> </code>
  
-==== Reference ==== 
- 
-Web Server configuration settings reference: 
-  
 === RootDirectory === === RootDirectory ===
  
Line 153: Line 154:
  
 **NOTE**: Older versions of Synchronet had this value default to ''../web/html'' **NOTE**: Older versions of Synchronet had this value default to ''../web/html''
 +
 +**NOTE**: If you change the root directory and use letsyncrypt for your certificate management, you will want to update the Domains section of letsyncrypt.ini in the ctrl directory. You will also need to do that if you have a virtual host so Let's Encrypt can find the correct document root.
 +
  
 === ErrorDirectory === === ErrorDirectory ===
Line 232: Line 236:
  
 The prefix of HTTP access log filenames, used when HTTP_LOGGING is enabled.  By default (when the ''ONE_HTTP_LOG'' option is **not** enabled), the current virtual host, date, and ''.log'' are appended to this string (e.g.''http-2005-03-12.log''). The prefix of HTTP access log filenames, used when HTTP_LOGGING is enabled.  By default (when the ''ONE_HTTP_LOG'' option is **not** enabled), the current virtual host, date, and ''.log'' are appended to this string (e.g.''http-2005-03-12.log'').
 +
 +=== CustomLogFormat ===
 +
 +When the ''CustomLogFormat'' setting is not used, the default format is the Apache "Combined Log Format".
 +
 +When the ''CustomLogFormat'' setting is used, the supported [[https://httpd.apache.org/docs/current/mod/mod_log_config.html|Apache Custom Log Format directives]] are:
 +
 +| %% | The percent sign | 
 +| %a | Client IP address of the request | 
 +| %B | Size of response in bytes, excluding HTTP headers. | 
 +| %b | Size of response in bytes, excluding HTTP headers. In CLF format |  
 +| %h | Remote hostname or IP address | 
 +| %H | The request protocol | 
 +| %l | Remote logname (from identd, if supplied) | 
 +| %p | Server TCP port number |
 +| %r | First line of request | 
 +| %s | Status | 
 +| %t | Time the request was received, in the format [18/Sep/2011:19:18:28 -0400] | 
 +| %u | Remote user if the request was authenticated | 
 +| %v | The canonical ServerName of the server serving the request. (the vhost) | 
 +| %{remote}p | the client's actual port | 
 +| %{Referer}i | the HTTP Referer [sic] header line | 
 +| %{User-agent}i | the HTTP User-agent header line |
 +
 +Note: Double-quote characters used in the format string do **not** need to be escaped (i.e. with a backslash)
 +
 +Example:
 +
 +This is the equivalent of Apache's combined log format which is used by default.
 +
 +    CustomLogFormat = %h %l %u %t "%r" %s - "%{Referer}i" "%{User-agent}i"
 +
 +This is the equivalent of Apache's vhost_combined log format.
 +    
 +    CustomLogFormat = %v:%p %h %l %u %t "%r" %s - "%{Referer}i" "%{User-agent}i"
 +
  
 === FileVPathPrefix === === FileVPathPrefix ===

Trace: