{"id":16368138,"url":"https://github.com/bfren/docker-nginx","last_synced_at":"2026-01-20T21:06:41.325Z","repository":{"id":37041861,"uuid":"310804553","full_name":"bfren/docker-nginx","owner":"bfren","description":"Docker Nginx image.","archived":false,"fork":false,"pushed_at":"2025-12-18T13:50:32.000Z","size":390,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-21T18:57:59.670Z","etag":null,"topics":["docker","docker-nginx","nginx"],"latest_commit_sha":null,"homepage":"","language":"Nushell","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/bfren.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"bfren","patreon":"bfren"}},"created_at":"2020-11-07T08:56:00.000Z","updated_at":"2025-12-18T13:45:51.000Z","dependencies_parsed_at":"2023-02-15T17:50:50.861Z","dependency_job_id":"51890515-727a-4140-9346-ba70fc0c151a","html_url":"https://github.com/bfren/docker-nginx","commit_stats":null,"previous_names":[],"tags_count":187,"template":false,"template_full_name":null,"purl":"pkg:github/bfren/docker-nginx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bfren%2Fdocker-nginx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bfren%2Fdocker-nginx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bfren%2Fdocker-nginx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bfren%2Fdocker-nginx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bfren","download_url":"https://codeload.github.com/bfren/docker-nginx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bfren%2Fdocker-nginx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28613713,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T18:56:40.769Z","status":"ssl_error","status_checked_at":"2026-01-20T18:54:26.653Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["docker","docker-nginx","nginx"],"created_at":"2024-10-11T02:51:45.474Z","updated_at":"2026-01-20T21:06:41.315Z","avatar_url":"https://github.com/bfren.png","language":"Nushell","funding_links":["https://github.com/sponsors/bfren","https://patreon.com/bfren"],"categories":[],"sub_categories":[],"readme":"# Docker Nginx\n\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/bfren/docker-nginx) ![Docker Pulls](https://img.shields.io/endpoint?url=https%3A%2F%2Fbfren.dev%2Fdocker%2Fpulls%2Fnginx) ![Docker Image Size](https://img.shields.io/endpoint?url=https%3A%2F%2Fbfren.dev%2Fdocker%2Fsize%2Fnginx) ![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/bfren/docker-nginx/dev.yml?branch=main)\n\n[Docker Repository](https://hub.docker.com/r/bfren/nginx) - [bfren ecosystem](https://github.com/bfren/docker)\n\nA simple Nginx base image - no SSL support etc, designed to be used behind a proxy server.\n\nFiles are served from /www/public (which can be overridden using BF_NGINX_PUBLIC_OVERRIDE).\n\n## Contents\n\n* [Ports](#ports)\n* [Volumes](#volumes)\n* [Environment Variables](#environment-variables)\n* [Helper Functions](#helper-functions)\n* [Nginx Configuration Helpers](#nginx-configuration-helpers)\n* [Licence / Copyright](#licence)\n\n## Ports\n\n* 80\n\n## Volumes\n\n| Volume | Purpose                                                                                                   |\n| ------ | --------------------------------------------------------------------------------------------------------- |\n| `/www` | Files in this directory are served by Nginx (if not mapped, a 'Welcome to Nginx' message will be served). |\n\n## Environment Variables\n\n| Variable                      | Values | Description                                                                                                        | Default            |\n| ----------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------ | ------------------ |\n| `BF_NGINX_FORWARD_ACCESS_LOG` | 0 or 1 | If 1, the access log will be forwarded to Docker's stdout.                                                         | 0                  |\n| `BF_NGINX_HEALTHCHECK_URI`    | URI    | The URI to load during the healthcheck.                                                                            | http://localhost   |\n| `BF_NGINX_IGNORE_FAVICON`     | 0 or 1 | If 1, a helper configuration file will contain a directive to return 204 (No Content) when a favicon is requested. | 1                  |\n| `BF_NGINX_PUBLIC_OVERRIDE`    | string | If set, it will be used as the nginx root directory (which by default is /www).                                    | *blank*            |\n\n## Helper Functions\n\n| Function       | Arguments | Description                                                            | Usage                                    |\n| -------------- | --------- | ---------------------------------------------------------------------- | ---------------------------------------- |\n| `healthcheck`  | *None*    | Loads BF_NGINX_HEALTHCHECK_URI to check everything is working.            | `docker exec \u003c\u003cCONTAINER\u003e\u003e healthcheck`  |\n| `nginx-reload` | *None*    | Tests Nginx configuration and if successful, reloads the Nginx server. | `docker exec \u003c\u003cCONTAINER\u003e\u003e nginx-reload` |\n\n## Nginx Configuration Helpers\n\nThe image contains a handful of useful Nginx configuration 'helper' files, which you can find in `/overlay/etc/nginx/helpers`.  They all begin with the prefix 'nginx':\n\n| Helper                 | Description                                                                                                                         |\n| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |\n| `-base.conf`           | Basic configuration, sets listen port, document root, and adds the [GNU Terry Pratchett](http://www.gnuterrypratchett.com/) header. |\n| `-ignore-favicon.conf` | Returns 204 for favicon.ico requests that do not exist, and stops it being added to the error log.                                  |\n| `-error-pages.conf`    | Include if you want to use Nginx's default error pages.                                                                             |\n| `-static-files.conf`   | Sets useful headers, cache, and expiration values for serving static files.                                                         |\n| `-uploads.conf`        | Sets `client_max_body_size` to 0 - so there is no limit on file upload size.                                                        |\n\n## Licence\n\n\u003e [MIT](https://mit.bfren.dev/2020)\n\n## Copyright\n\n\u003e Copyright (c) 2020-2026 [bfren](https://bfren.dev) (unless otherwise stated)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbfren%2Fdocker-nginx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbfren%2Fdocker-nginx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbfren%2Fdocker-nginx/lists"}