Nginx options and variables

About Nginx

Applications deployed with Maestro use Nginx as their web server, and its configuration is dependant on the resources of your server(s). Nginx is a high performance, open source web server used by some of the biggest web services in the world.

Default Cloud 66 Nginx error page

When there is a problem with your upstream server (ie. a container), requests will be passed to the default Cloud 66 error page. From there, you can visit the problematic server page in Cloud 66 dashboard to troubleshoot.

You can customise this page by following this guide.

Default Nginx configuration

The following table outlines the default configuration of Nginx.

Category
Attribute Default value
General -
user nginx
worker_processes Dynamically set based on instance size
error_log /var/deploy/[app_name]/web_head/shared/log/nginx_error.log
Events -
worker_connections 1024
HTTP -
gzip on
gzip_min_length 100
gzip_proxied expired no-cache no-store private auth
gzip_types text/plain application/xml text/css application/x-javascript text/javascript
gzip_disable "MSIE [1-6]\."
ssl_session_cache shared:SSL:10m
ssl_session_timeout 10m
underscores_in_headers on
default_type application/octet-stream
client_max_body_size 50m
sendfile on
server_tokens off
keepalive_timeout 65
Server -
listen 80 default_server
server_name _ or SSL server name
client_max_body_size 50m
root /var/deploy/[application name]/web_head/current/public
ssl_certificate_key /etc/ssl/localcerts/[ssl cerificate file name].key
ssl_certificate /etc/ssl/localcerts/[ssl cerificate file name].crt

Nginx worker configuration

The following table specifies the number of workers configured for your Nginx based on the server resources (CPU cores) on each cloud.

Cloud provider
Instance type Number of Workers
AWS -
t1.micro 1
m1.small 1
m1.medium 2
m1.large 2
m1.xlarge 4
m3.medium 1
m3.large 2
m3.xlarge 4
m3.2xlarge 8
m2.xlarge 2
m2.2xlarge 4
m2.4xlarge 8
c1.medium 2
c1.xlarge 8
c3.large 2
c3.xlarge 4
c3.2xlarge 8
c3.4xlarge 16
c3.8xlarge 32
cc2.8xlarge 88
i2.xlarge 4
i2.2xlarge 8
i2.4xlarge 16
i2.8xlarge 32
cr1.8xlarge 88
hi1.4xlarge 35
hs1.8xlarge 35
cg1.4xlarge 33
g2.2xlarge 8
DigitalOcean -
512MB - 1 CPU 1
1GB - 1 CPU 1
2GB - 2 CPU 2
4GB - 2 CPU 2
8GB - 4 CPU 4
16GB - 8 CPU 8
32GB - 12 CPU 12
48GB - 16 CPU 16
64GB - 20 CPU 20
96GB - 24 CPU 24
GCE -
n1-standard-1 1
n1-standard-2 2
n1-standard-4 4
n1-standard-8 8
n1-standard-16 16
n1-highmem-2 2
n1-highmem-4 4
n1-highmem-8 8
n1-highmem-16 16
n1-highcpu-2 2
n1-highcpu-4 4
n1-highcpu-8 8
n1-highcpu-16 16
f1-micro 1
g1-small 1
Linode -
Linode 1GB 1
Linode 2GB 2
Linode 4GB 4
Linode 8GB 6
Linode 16GB 8
Linode 32GB 12
Linode 48GB 16
Linode 64GB 20
Linode 96GB 20
Microsoft Azure -
ExtraSmall 1
Small 1
Medium 2
Large 4
ExtraLarge 8
A5 2
A6 4
A7 8
A8 8
A9 16
STANDARD_D1 1
STANDARD_D2 2
STANDARD_D3 4
STANDARD_D4 8
STANDARD_D11 2
STANDARD_D12 4
STANDARD_D13 8
STANDARD_D14 16
Rackspace -
512MB Standard Instance 1
1GB Standard Instance 1
2GB Standard Instance 2
4GB Standard Instance 2
8GB Standard Instance 4
15GB Standard Instance 6
30GB Standard Instance 8
3.75 GB Compute v1 2
7.5 GB Compute v1 4
15 GB Compute v1 8
30 GB Compute v1 16
60 GB Compute v1 32
1 GB General Purpose v1 1
2 GB General Purpose v1 2
4 GB General Purpose v1 4
8 GB General Purpose v1 8
15 GB I/O v1 4
30 GB I/O v1 8
60 GB I/O v1 16
90 GB I/O v1 24
120 GB I/O v1 32
15 GB Memory v1 2
30 GB Memory v1 4
60 GB Memory v1 8
120 GB Memory v1 16
240 GB Memory v1 32
1 GB Performance 2
2 GB Performance 2
4 GB Performance 4
8 GB Performance 8
15 GB Performance 4
30 GB Performance 8
60 GB Performance 16
90 GB Performance 24
120 GB Performance 32
CloudA -
512 MB 1
1 GB 1
2 GB 1
4 GB 2
8 GB 4
16 GB 6
32 GB 8
8 GB - HM 2
16 GB - HM 4
32 GB - HM 6
4 GB - HC 4
8 GB - HC 8
16 GB - HC 12