Mercurial > hg > nginx-site
annotate xml/en/docs/configure.xml @ 1872:f3f268ab3573
Updated with Netcraft December 2016 Web Server Survey stats.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Wed, 21 Dec 2016 18:29:10 +0300 |
parents | 153a99d25210 |
children | d011ffde3760 |
rev | line source |
---|---|
580
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
486
diff
changeset
|
1 <!-- |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
486
diff
changeset
|
2 Copyright (C) Igor Sysoev |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
486
diff
changeset
|
3 Copyright (C) Nginx, Inc. |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
486
diff
changeset
|
4 --> |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
486
diff
changeset
|
5 |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd"> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
7 |
924 | 8 <article name="Building nginx from Sources" |
9 link="/en/docs/configure.html" | |
589 | 10 lang="en" |
1749
153a99d25210
Updated versions of PCRE, zlib, and OpenSSL.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1653
diff
changeset
|
11 rev="7"> |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
12 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
13 <section> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
14 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
15 <para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
16 The build is configured using the <command>configure</command> command. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
17 It defines various aspects of the system, including the methods nginx |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
18 is allowed to use for connection processing. |
271 | 19 At the end it creates a <path>Makefile</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
20 The <command>configure</command> command supports the following parameters: |
461 | 21 <list type="bullet"> |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
22 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
23 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
24 <para> |
271 | 25 <literal>--prefix=<value>path</value></literal>—defines |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
26 a directory that will keep server files. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
27 This same directory will also be used for all relative paths set by |
271 | 28 <command>configure</command> (except for paths to libraries sources) |
29 and in the <path>nginx.conf</path> configuration file. | |
30 It is set to the <path>/usr/local/nginx</path> directory by default. | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
31 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
32 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
33 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
34 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
35 <para> |
271 | 36 <literal>--sbin-path=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
37 the name of an nginx executable file. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
38 This name is used only during installation. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
39 By default the file is named |
271 | 40 <path><value>prefix</value>/sbin/nginx</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
41 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
42 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
43 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
44 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
45 <para> |
271 | 46 <literal>--conf-path=<value>path</value></literal>—sets |
47 the name of an <path>nginx.conf</path> configuration file. | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
48 If needs be, nginx can always be started with a different configuration file, |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
49 by specifying it in the command-line parameter |
271 | 50 <nobr><literal>-c <value>file</value></literal></nobr>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
51 By default the file is named |
271 | 52 <path><value>prefix</value>/conf/nginx.conf</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
53 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
54 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
55 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
56 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
57 <para> |
271 | 58 <literal>--pid-path=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
59 the name of an nginx.pid file that will store the process ID |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
60 of the main process. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
61 After installation, the file name can always be changed in the |
271 | 62 <path>nginx.conf</path> configuration file using the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
63 <link doc="ngx_core_module.xml" id="pid"/> directive. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
64 By default the file is named |
271 | 65 <path><value>prefix</value>/logs/nginx.pid</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
66 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
67 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
68 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
69 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
70 <para> |
271 | 71 <literal>--error-log-path=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
72 the name of the primary error, warnings, and diagnostic file. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
73 After installation, the file name can always be changed in the |
271 | 74 <path>nginx.conf</path> configuration file using the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
75 <link doc="ngx_core_module.xml" id="error_log"/> directive. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
76 By default the file is named |
271 | 77 <path><value>prefix</value>/logs/error.log</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
78 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
79 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
80 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
81 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
82 <para> |
271 | 83 <literal>--http-log-path=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
84 the name of the primary request log file of the HTTP server. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
85 After installation, the file name can always be changed in the |
271 | 86 <path>nginx.conf</path> configuration file using the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
87 <link doc="http/ngx_http_log_module.xml" id="access_log"/> directive. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
88 By default the file is named |
271 | 89 <path><value>prefix</value>/logs/access.log</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
90 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
91 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
92 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
93 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
94 <para> |
271 | 95 <literal>--user=<value>name</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
96 the name of an unprivileged user whose credentials will be used |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
97 by worker processes. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
98 After installation, the name can always be changed in the |
271 | 99 <path>nginx.conf</path> configuration file using the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
100 <link doc="ngx_core_module.xml" id="user"/> directive. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
101 The default user name is nobody. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
102 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
103 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
104 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
105 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
106 <para> |
271 | 107 <literal>--group=<value>name</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
108 the name of a group whose credentials will be used |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
109 by worker processes. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
110 After installation, the name can always be changed in the |
271 | 111 <path>nginx.conf</path> configuration file using the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
112 <link doc="ngx_core_module.xml" id="user"/> directive. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
113 By default, a group name is set to the name of an unprivileged user. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
114 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
115 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
116 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
117 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
118 <para> |
271 | 119 <literal>--with-select_module</literal><br/> |
120 <literal>--without-select_module</literal>—enables or disables | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
121 building a module that allows the server to work with the |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
122 <c-func>select</c-func> method. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
123 This module is built automatically if the platform does not appear |
1465
eea7541e7c6a
Removed "rtsig" and "worker_rlimit_sigpending".
Ruslan Ermilov <ru@nginx.com>
parents:
924
diff
changeset
|
124 to support more appropriate methods such as kqueue, epoll, or /dev/poll. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
125 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
126 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
127 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
128 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
129 <para> |
271 | 130 <literal>--with-poll_module</literal><br/> |
131 <literal>--without-poll_module</literal>—enables or disables | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
132 building a module that allows the server to work with the |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
133 <c-func>poll</c-func> method. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
134 This module is built automatically if the platform does not appear |
1465
eea7541e7c6a
Removed "rtsig" and "worker_rlimit_sigpending".
Ruslan Ermilov <ru@nginx.com>
parents:
924
diff
changeset
|
135 to support more appropriate methods such as kqueue, epoll, or /dev/poll. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
136 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
137 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
138 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
139 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
140 <para> |
271 | 141 <literal>--without-http_gzip_module</literal>—disables building a module |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
142 that <link doc="http/ngx_http_gzip_module.xml">compresses responses</link> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
143 of an HTTP server. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
144 The zlib library is required to build and run this module. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
145 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
146 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
147 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
148 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
149 <para> |
271 | 150 <literal>--without-http_rewrite_module</literal>—disables building a |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
151 module that allows an HTTP server to |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
152 <link doc="http/ngx_http_rewrite_module.xml">redirect requests and change URI |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
153 of requests</link>. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
154 The PCRE library is required to build and run this module. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
155 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
156 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
157 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
158 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
159 <para> |
271 | 160 <literal>--without-http_proxy_module</literal>—disables building an |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
161 HTTP server <link doc="http/ngx_http_proxy_module.xml">proxying module</link>. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
162 <!-- |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
163 The MD5 library is required to build and run this module. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
164 --> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
165 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
166 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
167 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
168 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
169 <para> |
271 | 170 <literal>--with-http_ssl_module</literal>—enables building a module |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
171 that adds the <link doc="http/ngx_http_ssl_module.xml">HTTPS protocol |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
172 support</link> to an HTTP server. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
173 This module is not built by default. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
174 The OpenSSL library is required to build and run this module. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
175 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
176 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
177 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
178 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
179 <para> |
271 | 180 <literal>--with-pcre=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
181 the path to the sources of the PCRE library. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
182 The library distribution (version |
1749
153a99d25210
Updated versions of PCRE, zlib, and OpenSSL.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1653
diff
changeset
|
183 4.4—8.39) needs to be downloaded from the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
184 <link url="http://www.pcre.org">PCRE</link> site and extracted. |
924 | 185 The rest is done by nginx’s <command>./configure</command> and |
186 <command>make</command>. | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
187 The library is required for regular expressions support in the |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
188 <link doc="http/ngx_http_core_module.xml" id="location"/> directive |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
189 and for the |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
190 <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
191 module. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
192 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
193 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
194 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
195 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
196 <para> |
289
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
197 <literal>--with-pcre-jit</literal>—builds the PCRE library with |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
625
diff
changeset
|
198 “just-in-time compilation” support (1.1.12, the |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
625
diff
changeset
|
199 <link doc="ngx_core_module.xml" id="pcre_jit"/> directive). |
289
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
200 </para> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
201 </listitem> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
202 |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
203 <listitem> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
204 <para> |
271 | 205 <literal>--with-zlib=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
206 the path to the sources of the zlib library. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
207 The library distribution (version |
1653
dad548cf5b5f
Updated pcre and zlib versions.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1465
diff
changeset
|
208 1.1.3—1.2.8) needs to be downloaded from the |
858
65e75e59a714
Updated versions of external libraries and link to zlib site.
Valentin Bartenev <vbart@nginx.com>
parents:
732
diff
changeset
|
209 <link url="http://zlib.net">zlib</link> site and extracted. |
924 | 210 The rest is done by nginx’s <command>./configure</command> and |
211 <command>make</command>. | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
212 The library is required for the |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
213 <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link> module. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
214 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
215 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
216 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
217 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
218 <para> |
271 | 219 <literal>--with-cc-opt=<value>parameters</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
220 additional parameters that will be added to the CFLAGS variable. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
221 When using the system PCRE library under FreeBSD, |
271 | 222 <literal>--with-cc-opt="-I /usr/local/include"</literal> |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
223 should be specified. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
224 If the number of files supported by <c-func>select</c-func> needs to be |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
225 increased it can also be specified here such as this: |
271 | 226 <literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
227 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
228 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
229 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
230 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
231 <para> |
271 | 232 <literal>--with-ld-opt=<value>parameters</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
233 additional parameters that will be used during linking. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
234 When using the system PCRE library under FreeBSD, |
271 | 235 <literal>--with-ld-opt="-L /usr/local/lib"</literal> |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
236 should be specified. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
237 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
238 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
239 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
240 </list> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
241 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
242 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
243 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
244 <para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
245 Example of parameters usage (all of this needs to be typed in one line): |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
246 <programlisting> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
247 ./configure |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
248 --sbin-path=/usr/local/nginx/nginx |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
249 --conf-path=/usr/local/nginx/nginx.conf |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
250 --pid-path=/usr/local/nginx/nginx.pid |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
251 --with-http_ssl_module |
1749
153a99d25210
Updated versions of PCRE, zlib, and OpenSSL.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1653
diff
changeset
|
252 --with-pcre=../pcre-8.39 |
1653
dad548cf5b5f
Updated pcre and zlib versions.
Yaroslav Zhuravlev <yar@nginx.com>
parents:
1465
diff
changeset
|
253 --with-zlib=../zlib-1.2.8 |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
254 </programlisting> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
255 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
256 |
924 | 257 <para> |
258 After configuration, | |
259 nginx is compiled and installed using <command>make</command>. | |
260 </para> | |
261 | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
262 </section> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
263 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
264 </article> |