{"id":19197025,"url":"https://github.com/jitesoft/docker-nginx","last_synced_at":"2026-05-19T03:10:52.798Z","repository":{"id":76670200,"uuid":"198080626","full_name":"jitesoft/docker-nginx","owner":"jitesoft","description":"Docker image containing NginX on Alpine Linux.","archived":false,"fork":false,"pushed_at":"2025-06-30T09:43:14.000Z","size":131,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-30T10:38:00.009Z","etag":null,"topics":["alpine-linux","docker","dockerfile","hacktoberfest","jitesoft","nginx"],"latest_commit_sha":null,"homepage":"https://nginx.org","language":"Dockerfile","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/jitesoft.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":"2019-07-21T16:35:51.000Z","updated_at":"2025-06-30T09:43:18.000Z","dependencies_parsed_at":"2025-06-30T10:27:34.256Z","dependency_job_id":"55fd8ce7-cbe1-445e-b13b-f0c9670467d1","html_url":"https://github.com/jitesoft/docker-nginx","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jitesoft/docker-nginx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jitesoft%2Fdocker-nginx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jitesoft%2Fdocker-nginx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jitesoft%2Fdocker-nginx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jitesoft%2Fdocker-nginx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jitesoft","download_url":"https://codeload.github.com/jitesoft/docker-nginx/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jitesoft%2Fdocker-nginx/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266267290,"owners_count":23902334,"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":["alpine-linux","docker","dockerfile","hacktoberfest","jitesoft","nginx"],"created_at":"2024-11-09T12:15:18.903Z","updated_at":"2026-05-19T03:10:52.772Z","avatar_url":"https://github.com/jitesoft.png","language":"Dockerfile","funding_links":["https://opencollective.com/jitesoft-open-source","https://github.com/sponsors/jitesoft","https://www.patreon.com/jitesoft"],"categories":[],"sub_categories":[],"readme":"# Nginx\r\n\r\n[![Docker Pulls](https://img.shields.io/docker/pulls/jitesoft/nginx.svg)](https://cloud.docker.com/u/jitesoft/repository/docker/jitesoft/nginx)\r\n[![Back project](https://img.shields.io/badge/Open%20Collective-Tip%20the%20devs!-blue.svg)](https://opencollective.com/jitesoft-open-source)\r\n\r\nNginx running on alpine linux.\r\n\r\n### Notice\r\n\r\nDue to a currently unresolved issue with the x390s and ppc64 builds, images for those two architectures have been paused.\r\n\r\n## Tags\r\n\r\nThe image is built automatically via CI, using latest alpine as base image.\r\n\r\nImages can be found at:  \r\n\r\n* [Docker hub](https://hub.docker.com/r/jitesoft/nginx): `jitesoft/nginx`  \r\n* [GitLab](https://gitlab.com/jitesoft/dockerfiles/nginx): `registry.gitlab.com/jitesoft/dockerfiles/nginx`\r\n* [GitHub](https://github.com/orgs/jitesoft/packages/container/package/nginx): `ghcr.io/jitesoft/nginx`\r\n* [Quay](https://quay.io/jitesoft/nginx): `quay.io/jitesoft/nginx`  \r\n\r\n## Dockerfile\r\n\r\nDockerfile can be found at [GitLab](https://gitlab.com/jitesoft/dockerfiles/nginx) and [GitHub](https://github.com/jitesoft/docker-nginx)\r\n\r\n## Usage\r\n\r\nMost basic usage is to just run the container, nginx will start and serve the content in the /usr/local/nginx/html directory.  \r\nPort `80` is exposed by default.\r\n\r\n### www-data user\r\n\r\nThe www-data user have the same id as the www-data user in the most common alpine images, 82.  \r\nBefore 2021 07 23, the id was 1000, which created issues with read/write permissions\r\nwhen used with the jitesoft/php image.  \r\n\r\nContainers created runs as root (easily changed in production with the appropriate flags),\r\nwhile the nginx process runs as the www-data user (82) by default.\r\n\r\n### Template\r\n\r\nTo ease the setup process, the startup script will generate a default.conf file in the /etc/nginx/conf.d directory. Any files in said directory will be\r\nloaded into nginx by default.  \r\nWhen the template is generated, the script will run `envsubstr` to replace all template vars with passed environment variables. If you wish to customise the template\r\nyou may create a new template and set the `CONF_TEMPLATE` variable to the path of the file and use `${VARIABLE}` placeholders to replace those with the\r\nnamed env variables passed.\r\n\r\nThe default template file is located at `/usr/local/default.template` and exposes `LISTEN_PORT`, `SERVER_NAME` and `SERVER_ROOT` env variables and defaults to `80`, `localhost` and `/usr/local/nginx/html`.\r\n\r\nIt's also possible to change the full initial nginx configuration by replacing the `/etc/nginx/nginx.conf` file, while not recommended (rather create a new file to override in `/etc/nginx/conf.d`).\r\n\r\n### Healthcheck\r\n\r\nBy default, the container will run a health check - via the `healthcheck` shell script - every 30 seconds.  \r\nThe health check script uses wget to hit a special endpoint (`127.0.0.1:3999/__health`), which is automatically created in the `/etc/nginx/conf.d/000-healthcheck.conf` configuration.  \r\nIt's possible to turn the healthcheck off by setting `SKIP_HEALTHCHECK=true` as an env variable. The healthcheck will still run, but always return as healthy.  \r\n  \r\nChanging the healthcheck scripts is possible, while not recommended.\r\n\r\n## Image labels\r\n\r\nThis image follows the [Jitesoft image label specification 1.0.0](https://gitlab.com/snippets/1866155).\r\n\r\n## Licenses\r\n\r\nFiles in this repository are released under the MIT license.  \r\nNginx is released under [2-clause BSD-like license](https://nginx.org/LICENSE).\r\n\r\n## Sponsors\r\n\r\nJitesoft images are built via GitLab CI on runners hosted by the following wonderful organisations:\r\n\r\n\u003ca href=\"https://osuosl.org/\" target=\"_blank\" title=\"Oregon State University - Open Source Lab\"\u003e\r\n    \u003cimg src=\"https://jitesoft.com/images/oslx128.webp\" alt=\"Oregon State University - Open Source Lab\"\u003e\r\n\u003c/a\u003e\r\n\r\n_The companies above are not affiliated with Jitesoft or any Jitesoft Projects directly._\r\n\r\n---\r\n\r\nSponsoring is vital for the further development and maintaining of open source.  \r\nQuestions and sponsoring queries can be made by \u003ca href=\"mailto:sponsor@jitesoft.com\"\u003eemail\u003c/a\u003e.  \r\nIf you wish to sponsor our projects, reach out to the email above or visit any of the following sites:\r\n\r\n[Open Collective](https://opencollective.com/jitesoft-open-source)  \r\n[GitHub Sponsors](https://github.com/sponsors/jitesoft)  \r\n[Patreon](https://www.patreon.com/jitesoft)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjitesoft%2Fdocker-nginx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjitesoft%2Fdocker-nginx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjitesoft%2Fdocker-nginx/lists"}