Differences

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

--- web-nginx [2023/05/21 02:44] – -condense hogwild
+++ web-nginx [2023/06/27 20:46] (current) – [Status] -condense hogwild
@@ Line 1: / Line 1: @@
 ====== Nginx & PHP ======
-This menu contains settings for FreshTomato's internal webserver (Nginx) and optional support for PHP.  Note that FreshTomato also has a built-in (httpd) webserver used only for router administration. This additional minimal Webserver is based on a more modern version of Nginx.
+This menu contains settings for FreshTomato's internal web server (Nginx) and optional support for PHP.  Note that FreshTomato also has a built-in (httpd) web server used only for router administration. This additional minimal web server is based on a more modern version of Nginx.
+ \\
  \\
+===== Status =====
- \\ {{:pasted:20220215-152554.png}}\\  \\
+ \\  {{:pasted:20220215-152554.png}} \\   \\   \\
- \\ **NGINX is currently running/stopped:** This displays the service status and lets you stop and start the process via the [//Stop now//]/[//Start now//] button.
+**NGINX is currently running:** This displays the service status. Clicking [Stop Now] immediately stops the service.
-**Enable Server on Start:** Enabling this causes the nginx service to load at boot time during each boot.
+**NGINX is currently stopped:** This displays the service status. Clicking [Start Now] immediately stops the service.
-**Enable PHP support:** Enabling this option will cause any PHP pages served by the webserver to be interpreted.
+**Enable Server on Start:**  Enabling this causes the nginx service to load at boot time during each boot.
-**Run As:** The option chosen here define the system username that will run the nginx daemon.
+**Enable PHP support:**  Enabling this option will cause any PHP pages served by the webserver to be interpreted.
+**Run As:**  The option chosen here specifies under which system account the nginx daemon will run.
   * root - The nginx daemon will run under the root account.
-  * nobody - The nginx daemon will run under the nobody account. \\
+  * nobody - The nginx daemon will run under the nobody account.
+\\
 {{:pasted:20220215-153311.png}}\\  \\
-**Keep Config files:**
+**Keep Config files: TBD**
-**Web Server Port:** This specifies on which LAN port the Web content will be served.Traditionally, the default port for HTTP is 80. However, a conflict might occur if the httpd Web server were also configured to use the same port ([[admin_access|Admin Access]]). Consequently, the decision was made to make the default port here port 85.
+**Web Server Port:** This specifies on which LAN port Web content will be served. Traditionally, the default HTTP port is 80. However, a conflict might occur if the httpd web server were configured to use the same port (See: [[admin_access|Admin Access]]). Consequently, it was decided that port 85 would be the default for Nginx.
 **Upload file size limit:** This setting enforces a hard-coded limit for the maximum amount of data that can be uploaded in a single session.
-**Allow Remote Access:** Enabling this chooses whether Nginx content will be visible from the WAN. If enabled, content is served on the same port as the LAN's "Web Server Port".
+**Allow Remote Access:** Enabling this chooses whether Nginx content will be visible from the WAN. If enabled, content is served on the same port as the LAN's "Web Server Port". \\
- \\ \\  {{:pasted:20220215-153925.png}}\\
+ \\ {{:pasted:20220215-153925.png}}  \\   \\   \\ **Web Server Name:**  Here, you enter the web server's name. (Default: Tomato).
- **Web Server Name** : Defines the name (Tomato is the default).\\  **Document Root Path** : Indicates where the root folder for the content/pages is on the filesystem.\\  **Server Priority** : Set the "nice" value for the process. It can span between -20 (highest priority) and 19 (lowest priority).\\  **Enable h5ai support** : h5ai is a minimalistic php code that displays "boring" file/folder lists in a visually satisfying way. To benefit from h5ai you need to:
+**Document Root Path:**  Here, you specify the filesystem location of the root folder where content/pages are located.
-  * Enable this option
+**Server Priority:**  This set the "nice" value for the nginx process. This value assigns the Webserver process a CPU priority, relative to other processes. Valid settings are between -20 (highest priority) and 19 (lowest priority).
-  * Enable php on this very page
-  * Download [[https://larsjung.de/h5ai/|h5ai]] and copy the ''_h5ai'' folder right under the ''Document Root Path''
-{{:pasted:20220215-164209.png}}\\  The Custom Configuration fields allow to define custom directive to tweak the default behavior. For additional information please consult the updated offical nginx documentation.\\
+**Enable h5ai support:**  h5ai is a modern file indexer for HTTP Webervers with focus on your files. Its php code displays "boring" file/folder lists in an a more appealing way.
-{{:pasted:20220215-164428.png}}\\  **Use user config file** : User config file will be used, some of GUI settings are to be ignored\\  **User config file path** : Specify here the custom nginx config file (if any)
+In order to benefit from h5ai, you must:
+  * Enable the h5ai support option
+  * Enable PHP on this menu
+  * Download [[https://larsjung.de/h5ai/|h5ai]] and copy the ''_h5ai'' folder directly under the ''Document Root Path''
+===== Advanced Settings =====
+This field allows you to specify custom settings to tweak default behaviour. For additional information please consult the latest official NGINX [[https://nginx.org/en/|documentation]].
+ \\
+{{:pasted:20220215-164209.png}}
+\\  \\  \\
+{{:pasted:20220215-164428.png}}\\  \\
+**Use user config file:**  Here, choose whether a custom configuration file will be used. This will cause some web interface settings to to be overridden.
+**User config file path:**  Here, you can specify a custom path for the nginx configuration file. The settings in this file will be active only if //Use user config file// is enabled. When //Use user config file// is disabled, the path remains in the field, but is inactive.
+ \\
+ \\

FreshTomato Wiki

User Tools

Site Tools

Differences

Page Tools