README.md

⚙️ NGINX configuration generator on steroids 💉

The only tool you'll ever need to configure your NGINX server.
do.co/nginxconfig »

Report a bug · Request a feature

✨ NGINX Config

NGINX is so much more than just a webserver. You already knew that, probably.

We love NGINX, because:

• low memory usage
• high concurrency
• asynchronous event-driven architecture
• load balancing
• reverse proxying
• FastCGI support with caching (PHP)
• amazing fast handling of static files
• TLS/SSL with SNI

A lot of features with corresponding configuration directives. You can deep dive into the NGINX documentation right now OR you can use this tool to check how NGINX works, observe how your inputs are affecting the output, generate the best config for your specific use-case (and in parallel you can still use the docs).

🚀 Usage

GOTO do.co/nginxconfig

Features: HTTPS, HTTP/2, IPv6, certbot, HSTS, security headers, SSL profiles, OCSP resolvers, caching, gzip, brotli, fallback routing, reverse proxy, www/non-www redirect, CDN, PHP (TCP/socket, WordPress, Drupal, Magento), Node.js support, Python (Django) server, etc.

👨‍💻 Author

Rewrite & maintenance

Matt (IPv4) Cowley <[email protected]> (https://mattcowley.co.uk)

• GitHub: @MattIPv4

Original version

Bálint Szekeres <[email protected]> (https://balint.szekeres.me)

• GitHub: @0xB4LINT
• LinkedIn: @0xB4LINT

▶️ Development

1. Clone the repository

   git clone https://github.com/digitalocean/nginxconfig.io.git

2. Install NPM packages

   npm ci

3. Run the development server (with file watchers)

   npm run dev

4. Open the development site localhost:8080

5. Lint your code (eslint & sass-lint)

   npm test

6. Analyze production bundle size & composition

   npm run analyze

7. Build for production (to the dist directory)

   npm run build

🤝 Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

⚒️ Built With

• Vue.js - Template handling & app generation
• Bulma - Base styling, customised by do-bulma
• Prism - Bash & NGINX syntax highlighting

📚 Resources

• Mozilla SSL Configuration Generator v5
• Mozilla SSL Configuration Generator
• OWASP TLS Cipher String Cheat Sheet
• Nginx Optimization: understanding sendfile, tcp_nodelay and tcp_nopush
• NGINX Tuning For Best Performance
• Hardening Your HTTP Security Headers
• h5bp/server-configs-nginx
• Diffie-Hellman DSA-like parameters
• hstspreload.org
• Optimal value for nginx worker_connections

⭐️ Show your support

Give a ⭐️ if this project helped you!

📝 License

Copyright © 2020 DigitalOcean, Inc <[email protected]> (https://www.digitalocean.com).
This project is licensed under the MIT license.