{"id":26962240,"url":"https://github.com/vshuraeff/nginx-error-pages","last_synced_at":"2025-04-03T05:19:33.084Z","repository":{"id":284232976,"uuid":"954268597","full_name":"vshuraeff/nginx-error-pages","owner":"vshuraeff","description":"A set of error pages for nginx","archived":false,"fork":false,"pushed_at":"2025-03-24T21:21:53.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T21:30:08.010Z","etag":null,"topics":["error","html","nginx","pages"],"latest_commit_sha":null,"homepage":"https://vshuraeff.github.io/nginx-error-pages/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vshuraeff.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-03-24T20:23:05.000Z","updated_at":"2025-03-24T21:20:52.000Z","dependencies_parsed_at":"2025-03-24T21:31:40.323Z","dependency_job_id":"42e0603f-b130-4abc-bcc8-95b4c0a6d40e","html_url":"https://github.com/vshuraeff/nginx-error-pages","commit_stats":null,"previous_names":["vshuraeff/nginx-error-pages"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vshuraeff%2Fnginx-error-pages","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vshuraeff%2Fnginx-error-pages/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vshuraeff%2Fnginx-error-pages/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vshuraeff%2Fnginx-error-pages/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vshuraeff","download_url":"https://codeload.github.com/vshuraeff/nginx-error-pages/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246939610,"owners_count":20857989,"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":["error","html","nginx","pages"],"created_at":"2025-04-03T05:19:32.399Z","updated_at":"2025-04-03T05:19:33.073Z","avatar_url":"https://github.com/vshuraeff.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nginx Modern Error Pages\n\nThis repository contains a collection of modern, responsive, and visually appealing error pages for Nginx servers. These pages are designed to provide clear and user-friendly error messages for various HTTP status codes, improving the user experience when encountering server errors.\n\n\u003cimg width=\"1173\" alt=\"image\" src=\"https://github.com/user-attachments/assets/dc083172-2b59-4c38-9dd0-42ab09f84cbc\" /\u003e\n\u003cimg width=\"1173\" alt=\"image\" src=\"https://github.com/user-attachments/assets/781c9eb6-8404-44e7-977d-3cfe26c1317f\" /\u003e\n\n\n## Features\n\n- **Responsive Design**: Pages are fully responsive and adapt to both mobile and desktop screens, including 5K displays.\n- **Self-Contained**: Each HTML file includes its own CSS, requiring no external files.\n- **Customizable**: Easily modify the styles and content to match your branding.\n- **Comprehensive Coverage**: Includes error pages for common HTTP status codes (e.g., 400, 404, 500) and special cases like 418 (I'm a Teapot) and 451 (Unavailable for Legal Reasons).\n- **Maintenance Page**: A dedicated maintenance page for scheduled downtime.\n\u003cimg width=\"1173\" alt=\"image\" src=\"https://github.com/user-attachments/assets/e84fe151-b321-49b6-915a-44608cb786b6\" /\u003e\n\n## Included Files\n\n- **HTML Files**: Individual error pages for each HTTP status code (e.g., `400.html`, `404.html`, `500.html`), each containing its own embedded styles.\n- **Nginx Configuration**: A sample `nginx.conf` file to integrate the error pages with your Nginx server.\n\n## Installation Instructions\n\nFollow these steps to set up the error pages on your Nginx server:\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/vshuraeff/nginx-error-pages.git\ncd nginx-error-pages\n```\n\n### 2. Copy Files to Your Server\n\nCopy the error pages to a directory on your server. For example:\n\n```bash\nsudo cp *.html /usr/share/nginx/html/error_pages/\n```\n\n### 3. Update Nginx Configuration\n\nEdit your Nginx configuration file (e.g., `/etc/nginx/nginx.conf`) and add the following lines to configure the error pages:\n\n```nginx\n# Error pages configuration\nerror_page 400 /error_pages/400.html;\nerror_page 401 /error_pages/401.html;\nerror_page 403 /error_pages/403.html;\nerror_page 404 /error_pages/404.html;\nerror_page 405 /error_pages/405.html;\nerror_page 408 /error_pages/408.html;\nerror_page 418 /error_pages/418.html;\nerror_page 429 /error_pages/429.html;\nerror_page 451 /error_pages/451.html;\nerror_page 500 /error_pages/500.html;\nerror_page 501 /error_pages/501.html;\nerror_page 502 /error_pages/502.html;\nerror_page 503 /error_pages/503.html;\nerror_page 504 /error_pages/504.html;\nerror_page 505 /error_pages/505.html;\n\n# Maintenance configuration\n# Uncomment the following line when maintenance is needed\n# return 503 /error_pages/maintenance.html;\n\n# Under construction configuration\n# Uncomment this line and provide full path to file\n# index underconstruction.html;\n\n# Enable error page interception for proxy passthrough\nproxy_intercept_errors on;\n\n# Location for error pages\nlocation ^~ /error_pages/ {\n    internal;\n    alias /usr/share/nginx/html/error_pages/;\n    try_files $uri =404;\n}\n\n```\n\nOR include the provided `error_pages.conf` file in your Nginx configuration:\n\n```nginx\ninclude /path/to/error_pages.conf;\n```\n\nMake sure to update the paths to match the location where you copied the HTML files.\n\n### 4. Test the Configuration\n\nCheck the Nginx configuration for syntax errors:\n\n```bash\nsudo nginx -t\n```\n\nIf the test is successful, reload Nginx to apply the changes:\n\n```bash\nsudo systemctl reload nginx\n```\n\n### 5. Verify the Setup\n\nTrigger different HTTP errors (e.g., by accessing non-existent pages) to verify that the custom error pages are displayed correctly.\n\n## Customization\n\n- **Modify Content**: Edit the HTML files to customize the error messages or add additional information.\n- **Change Styles**: Update the styles within each HTML file to match your website's branding.\n- **Add New Pages**: Create additional error pages as needed and update the Nginx configuration to include them.\n\n\u003cimg width=\"1173\" alt=\"image\" src=\"https://github.com/user-attachments/assets/5f54bdf2-1bec-40d2-b78d-977834b7f3a8\" /\u003e\n\n\n## Benefits of Self-Contained Pages\n\nEach HTML file contains its own CSS styles, providing several advantages:\n\n- **Simplified Deployment**: No need to manage external CSS files.\n- **Better Reliability**: Pages will still display correctly even if external resources are unavailable.\n- **Faster Loading**: No additional HTTP requests for external stylesheets.\n- **Easy Maintenance**: Each page can be edited independently.\n\n## License\n\nThis project is licensed under the MIT License. You are free to use, modify, and distribute it as needed.\n\n## Contributing\n\nContributions are welcome! Feel free to submit issues or pull requests to improve the project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvshuraeff%2Fnginx-error-pages","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvshuraeff%2Fnginx-error-pages","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvshuraeff%2Fnginx-error-pages/lists"}