Module nginx
In: /modules/nginx/manifests/init.pp


Install, enable and configure an NGINX web server instance with its main configuration file options as well as additional configuration snippets.

The module is very Red Hat Enterprise Linux focused, as the defaults try to change everything in ways which are typical for RHEL, but it also works on other distributions and is very easy to port if needed.

  • `nginx` : Main class for the NGINX web server.
  • `nginx::file` : Manage additional configuration snippets.
  • `nginx::params` : Class to set distribution specific defaults.

# Sample Usage

    # Default server, with a typical minimal virtualhost and ready for PHP-FPM
    include nginx
    nginx::file { '':
        content => template('mymodule/'),
    # Use the included example FastCGI for PHP configuration
    nginx::file { '':
        source => 'puppet:///modules/nginx/',

# Sample configuration file mymodule/ :

    # Fix for "upstream sent too big header ..." errors
    fastcgi_buffers 8 8k;
    fastcgi_buffer_size 8k;
    upstream fpmbackend {
        server unix:/var/run/php-fpm-www.sock;
    # Main virtualhost
    server {
        listen 80;
        root /var/www/;
        include /etc/nginx/conf.d/;
        access_log /var/log/nginx/ main;
        error_log /var/log/nginx/;



Classes and Modules

Class nginx::nginx
Class nginx::params


file( $source => 'undef', $content => 'undef' )

Define: nginx::file

Manage NGINX configuration file snippets, installed from source or template. The main service is automatically notified when files are added, removed or modified.


   Content for the file, typically from a template. Default: none
   Source for the file. Mutually exclusive with $content. Default: none

Sample Usage :

 nginx::file { 'example1.conf':
     source => 'puppet:///files/nginx/example1.conf',
 nginx::file { 'example2.conf':
     content => template('mymodule/example2.conf.erb'),