FAQ

Page Discussion History

Install

(Difference between revisions)
(Development)
(Development)
 
(32 intermediate revisions by 2 users not shown)
Line 35: Line 35:
  
 
= Official Debian/Ubuntu packages =
 
= Official Debian/Ubuntu packages =
Append the appropriate stanza to /etc/apt/sources.list:
+
Append the appropriate stanza to /etc/apt/sources.list. The [[Pgp]] page explains the signing of the nginx.org released packaging.
  
 
Ubuntu 10.04:
 
Ubuntu 10.04:
Line 77: Line 77:
  
 
= Official Win32 Binaries =
 
= Official Win32 Binaries =
As of {{Version_Development}}, Nginx is now available as an [http://www.nginx.org/download/nginx-1.0.9.zip official Windows binary].
+
As of {{Version_Development}}, Nginx is now available as an [http://www.nginx.org/download/nginx-1.2.2.zip official Windows binary].
  
 
The Windows version is provided as a binary-only due to the current build process (which currently uses some Wine tools).  When the build process has been cleaned up, source will be made available.  Igor does not want to support build issues with the current system.   
 
The Windows version is provided as a binary-only due to the current build process (which currently uses some Wine tools).  When the build process has been cleaned up, source will be made available.  Igor does not want to support build issues with the current system.   
Line 84: Line 84:
 
<geshi lang="shell">
 
<geshi lang="shell">
 
cd c:\
 
cd c:\
unzip nginx-1.0.9.zip
+
unzip nginx-1.2.2.zip
ren nginx-1.0.9 nginx
+
ren nginx-1.2.2 nginx
 
cd nginx
 
cd nginx
 
start nginx
 
start nginx
Line 98: Line 98:
  
  
In addition, [[KevinWorthington|Kevin Worthington]] maintains earlier [http://www.kevinworthington.com/nginx-for-windows/ Windows] builds of the development branch.
+
In addition, Kevin Worthington maintains earlier [http://www.kevinworthington.com/nginx-for-windows/ Windows] builds of the development branch.
  
 
= Source Releases =
 
= Source Releases =
There are currently three versions of Nginx available: '''stable (1.0.x)''', '''development (1.1.x)''', and '''legacy (0.8.x)'''. The development branch gets new features and bugfixes sooner but might introduce new bugs as well.  Once bugfixes are stabilized they are backported to the stable branch.  New features may or may not be backported.
+
There are currently three versions of Nginx available: '''stable (1.2.x)''', '''development (1.3.x)''', and '''legacy (0.8.x)'''. The development branch gets new features and bugfixes sooner but might introduce new bugs as well.  Once bugfixes are stabilized they are backported to the stable branch.  New features may or may not be backported.
  
 
In general, the stable release is recommended, but the development release is typically quite stable as well.  See the [[Faq#Is_it_safe_to_use_the_development_branch_in_production.3F|FAQ]].
 
In general, the stable release is recommended, but the development release is typically quite stable as well.  See the [[Faq#Is_it_safe_to_use_the_development_branch_in_production.3F|FAQ]].
Line 112: Line 112:
 
<div class="content-download-link">
 
<div class="content-download-link">
 
== Stable ==
 
== Stable ==
[http://nginx.org/download/nginx-1.0.11.tar.gz Nginx 1.0.11]<br />
+
[http://nginx.org/download/nginx-1.2.2.tar.gz Nginx 1.2.2]<br />
Dec 15, 2011<br />  
+
July 3, 2012<br />  
[http://nginx.org/en/CHANGES-1.0 changelog]
+
[http://nginx.org/en/CHANGES-1.2 changelog]
 
</div>  
 
</div>  
 
</li>
 
</li>
Line 122: Line 122:
  
 
== Development ==
 
== Development ==
[http://nginx.org/download/nginx-1.1.14.tar.gz Nginx 1.1.14]<br />
+
[http://nginx.org/download/nginx-1.3.3.tar.gz Nginx 1.3.3]<br />
Jan 30, 2012<br />  
+
July 10, 2012<br />  
 
[http://nginx.org/en/CHANGES changelog]
 
[http://nginx.org/en/CHANGES changelog]
 
</div>  
 
</div>  
Line 131: Line 131:
 
<div class="content-download-link">
 
<div class="content-download-link">
  
== Legacy ==
 
[http://nginx.org/download/nginx-0.8.55.tar.gz Nginx 0.8.55]<br />
 
July 19, 2010<br />
 
[http://nginx.net/CHANGES-0.8 changelog]
 
</div>
 
</li>
 
 
<li class="content-download-item">
 
<div class="content-download-link">
 
 
== Subversion ==
 
== Subversion ==
 
[svn://svn.nginx.org/nginx svn.nginx.org/nginx]<br />
 
[svn://svn.nginx.org/nginx svn.nginx.org/nginx]<br />
Line 150: Line 141:
 
<br style="clear: both;" />
 
<br style="clear: both;" />
  
[http://sysoev.ru/nginx/download.html Show all versions]
+
Older versions can be found [http://sysoev.ru/nginx/download.html here].
  
 
== Building Nginx From Source ==
 
== Building Nginx From Source ==
Line 165: Line 156:
  
 
You might also want to peruse the [[Nginx3rdPartyModules|catalog of third-party modules]], since these must be built at compile-time.
 
You might also want to peruse the [[Nginx3rdPartyModules|catalog of third-party modules]], since these must be built at compile-time.
 +
 +
== Other Systems ==
 +
 +
This is a list of other community maintained pages explaining other installations. Please note, that these pages are not thoroughly, if at all, reviewed for accuracy as they are on this page.
 +
 +
[[Installing_on_Solaris_10_u5| Solaris 10u5]]
 +
 +
[[Installing_on_Solaris_11| Solaris 11]]
  
 
= References =
 
= References =
 
[http://sysoev.ru/nginx/docs/install.html Original Documentation]
 
[http://sysoev.ru/nginx/docs/install.html Original Documentation]

Latest revision as of 17:54, 10 July 2012

Contents

[edit] After Installing

The Configuration page will give you some help getting things going after you get Nginx installed and the Pitfalls page will help keep you from making mistakes that so many users before you did. These two pages give you the chance to learn from others mistakes and hard work.

[edit] Binary Releases

[edit] Prebuilt Packages for Linux and BSD

Most Linux distributions and BSD variants have Nginx in the usual package repositories and they can be installed via whatever method is normally used to install software (apt-get on Debian, emerge on Gentoo, ports on FreeBSD, etc).

Be aware that these packages are often somewhat out-of-date. If you want the latest features and bugfixes, it's recommended to build from source or use packages directly from nginx.org.

[edit] Official Red Hat/CentOS packages

To add nginx yum repository, create a file named /etc/yum.repos.d/nginx.repo and paste one of the configurations below:

CentOS:

[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=0
enabled=1

RHEL:

[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/rhel/$releasever/$basearch/
gpgcheck=0
enabled=1

Due to differences between how CentOS, RHEL, and Scientific Linux populate the $releasever variable, it is necessary to manually replace $releasever with either "5" (for 5.x) or "6" (for 6.x), depending upon your OS version.

[edit] Official Debian/Ubuntu packages

Append the appropriate stanza to /etc/apt/sources.list. The Pgp page explains the signing of the nginx.org released packaging.

Ubuntu 10.04:

deb http://nginx.org/packages/ubuntu/ lucid nginx
deb-src http://nginx.org/packages/ubuntu/ lucid nginx

Debian 6:

deb http://nginx.org/packages/debian/ squeeze nginx
deb-src http://nginx.org/packages/debian/ squeeze nginx

[edit] Ubuntu PPA

This PPA is maintained by volunteers and is not distributed by nginx.org. It has some additional compiled-in modules and may be more fitting for your environment.

You can get the latest stable version of Nginx from the Nginx PPA on Launchpad: You will need to have root privileges to perform the following commands.

For Ubuntu 10.04 and newer:

sudo -s
nginx=stable # use nginx=development for latest development version
add-apt-repository ppa:nginx/$nginx
apt-get update 
apt-get install nginx

If you get an error about add-apt-repository not existing, you will want to install python-software-properties. For other Debian/Ubuntu based distributions, you can try the lucid variant of the PPA which is the most likely to work on older package sets.

sudo -s
nginx=stable # use nginx=development for latest development version
echo "deb http://ppa.launchpad.net/nginx/$nginx/ubuntu lucid main" > /etc/apt/sources.list.d/nginx-$nginx-lucid.list
apt-key adv --keyserver keyserver.ubuntu.com --recv-keys C300EE8C
apt-get update 
apt-get install nginx

[edit] Official Win32 Binaries

As of 0.8.50, Nginx is now available as an official Windows binary.

The Windows version is provided as a binary-only due to the current build process (which currently uses some Wine tools). When the build process has been cleaned up, source will be made available. Igor does not want to support build issues with the current system.

Installation:

cd c:\
unzip nginx-1.2.2.zip
ren nginx-1.2.2 nginx
cd nginx
start nginx

Control:

nginx -s [ stop | quit | reopen | reload ]

For problems look in c:\nginx\logs\error.log or in EventLog.


In addition, Kevin Worthington maintains earlier Windows builds of the development branch.

[edit] Source Releases

There are currently three versions of Nginx available: stable (1.2.x), development (1.3.x), and legacy (0.8.x). The development branch gets new features and bugfixes sooner but might introduce new bugs as well. Once bugfixes are stabilized they are backported to the stable branch. New features may or may not be backported.

In general, the stable release is recommended, but the development release is typically quite stable as well. See the FAQ.



Older versions can be found here.

[edit] Building Nginx From Source

After extracting the source, run these commands from a terminal:

./configure
make
sudo make install

By default, Nginx will be installed in /usr/local/nginx. You may change this and other options with the compile-time options.

You might also want to peruse the catalog of third-party modules, since these must be built at compile-time.

[edit] Other Systems

This is a list of other community maintained pages explaining other installations. Please note, that these pages are not thoroughly, if at all, reviewed for accuracy as they are on this page.

Solaris 10u5

Solaris 11

[edit] References

Original Documentation