{"id":29014051,"url":"https://github.com/farruhzoirov/fast-nginx","last_synced_at":"2026-01-20T17:33:40.340Z","repository":{"id":299805646,"uuid":"1004253880","full_name":"farruhzoirov/fast-nginx","owner":"farruhzoirov","description":"A fast and easy-to-use CLI tool to configure your domain with Nginx using just a single command.","archived":false,"fork":false,"pushed_at":"2025-06-25T17:32:15.000Z","size":44,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-25T18:37:25.359Z","etag":null,"topics":["cli","deployment","nginx","npm-package","ubuntu-server"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/fast-nginx","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/farruhzoirov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-18T10:51:42.000Z","updated_at":"2025-06-25T17:32:19.000Z","dependencies_parsed_at":"2025-06-25T18:25:33.654Z","dependency_job_id":null,"html_url":"https://github.com/farruhzoirov/fast-nginx","commit_stats":null,"previous_names":["farruhzoirov/fast-nginx"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/farruhzoirov/fast-nginx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farruhzoirov%2Ffast-nginx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farruhzoirov%2Ffast-nginx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farruhzoirov%2Ffast-nginx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farruhzoirov%2Ffast-nginx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/farruhzoirov","download_url":"https://codeload.github.com/farruhzoirov/fast-nginx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/farruhzoirov%2Ffast-nginx/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261935599,"owners_count":23232810,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","deployment","nginx","npm-package","ubuntu-server"],"created_at":"2025-06-25T20:12:40.645Z","updated_at":"2026-01-20T17:33:40.335Z","avatar_url":"https://github.com/farruhzoirov.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FastNginx 🚀\n\n[![npm version](https://badge.fury.io/js/fastnginx.svg)](https://badge.fury.io/js/fastnginx)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js CI](https://github.com/yourusername/fastnginx/workflows/Node.js%20CI/badge.svg)](https://github.com/yourusername/fastnginx/actions)\n\n**The fastest way to set up Nginx server blocks with SSL support.**\n\nFastNginx is a production-ready CLI tool that automates the entire process of setting up Nginx reverse proxy configurations, from basic server blocks to SSL certificates with Let's Encrypt.\n\n## ✨ Features\n\n- 🚀 **One-command setup** - Domain to production in seconds\n- 🔒 **Automatic SSL** - Let's Encrypt integration with auto-renewal\n- 📋 **Multiple templates** - Basic, API, and SPA configurations\n- 🛡️ **Security headers** - Production-ready security configurations\n- 🔍 **System validation** - Checks requirements before execution\n- 🎯 **Dry-run mode** - Preview changes before applying\n- 📊 **Detailed logging** - Clear feedback and error handling\n- 🌐 **Cross-platform** - Linux support\n\n## 🚀 Quick Start\n\n### Installation\n\n\\`\\`\\`bash\n\n# Install globally via npm\n\nnpm install -g fast-nginx\n\n# Verify installation\n\nfast-nginx --version\n\\`\\`\\`\n\n### Basic Usage\n\n\\`\\`\\`bash\n\n# Basic HTTP setup\n\nsudo fast-nginx --domain myapp.com --port 3000\n\n# Complete HTTPS setup\n\nsudo fast-nginx --domain myapp.com --port 3000 --ssl --email admin@myapp.com\n\n\n## 📖 Documentation\n\n### Command Options\n\n| Option                  | Description                         | Default |\n| ----------------------- | ----------------------------------- | ------- |\n| `-d, --domain \u003cdomain\u003e` | Domain name (required)              | -       |\n| `-p, --port \u003cport\u003e`     | Upstream port                       | 3000    |\n| `--ssl`                 | Setup SSL certificate               | false   |\n| `--email \u003cemail\u003e`       | Email for SSL (required with --ssl) | -       |\n| `--www`                 | Include www subdomain               | false   |\n| `--template \u003ctype\u003e`     | Configuration template              | basic   |\n| `--force`               | Overwrite existing config           | false   |\n| `--dry-run`             | Preview without executing           | false   |\n| `--no-reload`           | Skip Nginx reload                   | false   |\n\n### Templates\n\n#### Basic Template\n\nPerfect for most web applications:\n\\`\\`\\`bash\nfast-nginx --domain myapp.com --template basic\n\\`\\`\\`\n\n\n### Examples\n\n#### Simple Website\n\n\\`\\`\\`bash\n\n# Setup a basic website\n\nsudo fast-nginx --domain mywebsite.com --port 3000 --ssl --email admin@mywebsite.com\n\\`\\`\\`\n\n\n#### Preview Changes\n\n\\`\\`\\`bash\n\n# See what would be created without executing\n\nfast-nginx --domain test.com --ssl --email test@test.com --dry-run\n\\`\\`\\`\n\n## 🔧 Requirements\n\n- **Operating System**: Linux, Ubuntu\n- **Node.js**: 14.0.0 or higher\n- **Nginx**: Installed and running\n- **Permissions**: Root/sudo access for system operations\n- **Network**: Ports 80 and 443 accessible from internet (for SSL)\n\n## 📋 Installation Requirements\n\n### Ubuntu/Debian\n\n\\`\\`\\`bash\n\n# Update system\n\nsudo apt update \u0026\u0026 sudo apt upgrade -y\n\n# Install Node.js\n\ncurl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -\nsudo apt-get install -y nodejs\n\n# Install Nginx\n\nsudo apt install nginx -y\n\n# Install FastNginx (that's it!)\n\nsudo npm install -g fast-nginx\n\\`\\`\\`\n\n### CentOS/RHEL\n\n\\`\\`\\`bash\n\n# Install Node.js\n\ncurl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -\nsudo yum install -y nodejs\n\n# Install Nginx\n\nsudo yum install nginx -y\n\n# Install FastNginx\n\nsudo npm install -g fast-nginx\n\\`\\`\\`\n\n## 🛡️ Security Features\n\nFastNginx includes production-ready security configurations:\n\n- **Security Headers**: X-Frame-Options, X-XSS-Protection, X-Content-Type-Options\n- **SSL/TLS**: Automatic HTTPS redirect and modern cipher suites\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n**Permission Denied**\n\\`\\`\\`bash\n\n# Always run with sudo for system operations\n\nsudo fast-nginx --domain myapp.com\n\\`\\`\\`\n\n**Domain Not Accessible**\n\\`\\`\\`bash\n\n# Check DNS resolution\n\ndig myapp.com +short\n\n# Verify app is running\n\nnetstat -tuln | grep :3000\n\\`\\`\\`\n\n**SSL Certificate Failed**\n\\`\\`\\`bash\n\n# Ensure domain points to your server\n\n# Check firewall allows ports 80 and 443\n\nsudo ufw allow 80\nsudo ufw allow 443\n\\`\\`\\`\n\n**Nginx Configuration Error**\n\\`\\`\\`bash\n\n# Test configuration\n\nsudo nginx -t\n\n# Check logs\n\nsudo tail -f /var/log/nginx/error.log\n\\`\\`\\`\n\n### Getting Help\n\n- 📖 [Documentation](https://github.com/yourusername/fastnginx#readme)\n- 🐛 [Report Issues](https://github.com/yourusername/fastnginx/issues)\n- 💬 [Discussions](https://github.com/yourusername/fastnginx/discussions)\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Development Setup\n\n\\`\\`\\`bash\n\n# Clone repository\n\ngit clone https://github.com/yourusername/fastnginx.git\ncd fast-nginx\n\n# Install dependencies\n\nnpm install\n\n# Make executable\n\nchmod +x bin/cli.js\n\n# Test locally\n\n./bin/cli.js --help\n\n# Install globally for testing\n\nnpm link\n\\`\\`\\`\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- [Nginx](https://nginx.org/) - High-performance web server\n- [Let's Encrypt](https://letsencrypt.org/) - Free SSL certificates\n- [Commander.js](https://github.com/tj/commander.js/) - CLI framework\n- [Chalk](https://github.com/chalk/chalk) - Terminal styling\n\n## 📊 Stats\n\n![GitHub stars](https://img.shields.io/github/stars/farruhzoirov/fastnginx?style=social)\n![GitHub forks](https://img.shields.io/github/forks/farruhzoirov/fastnginx?style=social)\n![npm downloads](https://img.shields.io/npm/dm/fast-nginx)\n\n---\n\n**Made with ❤️ for the DevOps community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarruhzoirov%2Ffast-nginx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffarruhzoirov%2Ffast-nginx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffarruhzoirov%2Ffast-nginx/lists"}