Nginx Documentation¶

Entry point for version-specific Nginx configuration, measurement, and proxy management

Scope of This Index¶

This page is a navigation and quick-reference entry point. Nginx directives, process behavior, package paths, TLS options, and deployment commands depend on the Nginx or OpenResty build, modules, OS or image, and topology. Treat summaries as pointers; verify syntax, security assumptions, failure behavior, and rollback in the linked guide and the documentation for the deployed version.

Topics¶

Configuration

Comprehensive Nginx configuration guide including virtual hosts, SSL, and optimization.

View Guide
Proxy Manager

Nginx Proxy Manager setup and usage for easy reverse proxy management.

View Guide
Docker & K8s

Guide for deploying Nginx on Docker and Kubernetes environments.

View Guide

Nginx Architecture¶

flowchart LR
    subgraph Internet
        A[Clients]
    end

    subgraph Nginx
        B[Listener :80/:443]
        C{Router}
    end

    subgraph Backend
        D[Static Files]
        E[App Server 1]
        F[App Server 2]
        G[API Server]
    end

    A --> B
    B --> C
    C -->|/static| D
    C -->|/app| E
    C -->|/app| F
    C -->|/api| G

Common Use Cases¶

Use Case	Description	Config Section
Static Hosting	Serve HTML, CSS, JS files	`root`, `index`
Reverse Proxy	Forward to backend servers	`proxy_pass`
Load Balancing	Distribute traffic	`upstream`
SSL Termination	Handle HTTPS	`ssl_certificate`
Caching	Cache static content	`proxy_cache`

Quick Reference¶

Basic Server Block¶

server {
    listen 80;
    server_name example.com;
    root /var/www/html;

    location / {
        try_files $uri $uri/ =404;
    }
}

Reverse Proxy¶

server {
    listen 80;
    server_name api.example.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Load Balancer¶

upstream backend {
    server 192.168.1.10:8080 weight=3;
    server 192.168.1.11:8080 weight=2;
    server 192.168.1.12:8080 backup;
}

server {
    listen 80;
    location / {
        proxy_pass http://backend;
    }
}

Common Commands¶

# Test configuration
sudo nginx -t

# Reload configuration
sudo systemctl reload nginx

# View logs
tail -f /var/log/nginx/access.log
tail -f /var/log/nginx/error.log