Nginx Config Generator

Generate an Nginx server block for a reverse proxy, static site, single page app or PHP, with HTTPS, redirects, gzip and caching.

What should it do?Domain name(s)App address

More options

HTTPSRedirect HTTP to HTTPSHSTSCompression (gzip)Cache static filesSecurity headersWebSocket supportLargest upload

nginx configuration

server {
    listen 80;
    listen [::]:80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;
    server_name example.com;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;

    client_max_body_size 10m;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;

    gzip on;
    gzip_vary on;
    gzip_min_length 1024;
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml image/svg+xml;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Shortcuts: Ctrl+Enter run · Ctrl+Shift+C copy result · / search (use ⌘ on Mac)

Free Online Nginx Config Generator

Choose what the server should do, enter your domain, and get an Nginx configuration you can paste and test. HTTPS, redirects and sensible defaults are included. It gives developers a quick browser-based way to solve a focused nginx config generator task before moving the result into a project.

How to generate a config

Pick a type (reverse proxy, static site, single page app or PHP), enter the domain and, for a proxy, the address of your app. Copy the result into your Nginx configuration.

Testing it

Run sudo nginx -t. It tells you if the file is valid before you reload the server.

Common mistakes

Forgetting the semicolon at the end of a directive: Nginx refuses to start and names the line.
Pointing proxy_pass at a port the app does not listen on, which gives a 502 Bad Gateway.

Frequently asked questions

Where does the file go?

Save it in /etc/nginx/conf.d/example.conf or /etc/nginx/sites-available/ (and link it in sites-enabled), then run nginx -t to test and systemctl reload nginx.

Where do the HTTPS certificates come from?

The paths match what Certbot (Let's Encrypt) creates under /etc/letsencrypt/live/<domain>/. Run certbot first, or change the two paths to your own certificate files.

What is the single page app preset?

It serves index.html for any address that is not a real file, which React, Vue and Angular apps with client-side routing need.

Should I turn on HSTS?

Only when you are sure HTTPS works for the whole site. HSTS tells browsers to refuse plain HTTP for a year, so a mistake is hard to undo.

How do I use this nginx config generator tool?

Use the interactive controls above; processing stays in your browser and the result is intended as a practical starting point for development work.

More DevOps & Network

Docker Compose BuilderBuild a Docker setup by picking services Dockerfile LinterFind problems in a Dockerfile Kubernetes YAML ValidatorCheck Kubernetes files before deploying .env Parser & ValidatorCheck .env settings files .gitignore GeneratorCreate a .gitignore for your project .htaccess GeneratorCreate redirects and HTTPS rules chmod CalculatorWork out file permission numbers Crontab GeneratorBuild a schedule by picking times

View all DevOps & Network tools →