{"id":31904449,"url":"https://github.com/cloudfoundry-community/nginx-release","last_synced_at":"2025-10-13T13:50:02.957Z","repository":{"id":27151222,"uuid":"30620324","full_name":"cloudfoundry-community/nginx-release","owner":"cloudfoundry-community","description":"BOSH-deployed nginx webserver","archived":false,"fork":false,"pushed_at":"2022-11-28T15:06:07.000Z","size":109,"stargazers_count":8,"open_issues_count":0,"forks_count":24,"subscribers_count":33,"default_branch":"master","last_synced_at":"2024-04-13T06:56:57.167Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudfoundry-community.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}},"created_at":"2015-02-10T23:30:17.000Z","updated_at":"2024-02-09T14:27:35.000Z","dependencies_parsed_at":"2023-01-14T06:06:16.773Z","dependency_job_id":null,"html_url":"https://github.com/cloudfoundry-community/nginx-release","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/cloudfoundry-community/nginx-release","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fnginx-release","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fnginx-release/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fnginx-release/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fnginx-release/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudfoundry-community","download_url":"https://codeload.github.com/cloudfoundry-community/nginx-release/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fnginx-release/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279015348,"owners_count":26085686,"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","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-10-13T13:49:13.100Z","updated_at":"2025-10-13T13:50:02.945Z","avatar_url":"https://github.com/cloudfoundry-community.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# No Longer Maintained\n\nThis release is no longer being maintained.\n\nPlease use \u003chttps://github.com/bosh-packages/nginx-release\u003e instead.\n\n# BOSH-deployed nginx Server\n\nThis [BOSH](https://bosh.io/) release deploys an nginx webserver.\n\n***Warning: You may receive HTTP 403 Status (\"forbidden\") or see  \"permission\ndenied\" errors in your logs when using stemcells \u003e= 3541.x; to fix, set the\nworker's UNIX group to `vcap` at the top of your `nginx_conf` property with the\nfollowing line:***\n\n```\nuser nobody vcap; # group vcap can read most directories\n```\n\n### 0. Quick Start\n\n#### 0.0 Quick Start: Pre-requisites\n\nYou must have a BOSH Director and have uploaded stemcells to it. Our examples assume the [BOSH CLI v2](https://github.com/cloudfoundry/bosh-cli).\n\nFollow the instructions to install BOSH Lite: \u003chttps://bosh.io/docs/bosh-lite\u003e;\nupload the Cloud Config, set the routes, but no need to deploy Zookeeper.\n\nUpload Ubuntu stemcell\n\n```bash\nbosh -e vbox us https://s3.amazonaws.com/bosh-core-stemcells/warden/bosh-stemcell-3468-warden-boshlite-ubuntu-trusty-go_agent.tgz\n```\n\nClone the nginx repository:\n\n```bash\ncd ~/workspace\ngit clone https://github.com/cloudfoundry-community/nginx-release.git\ncd nginx-release\n```\n\n#### 0.1 Quick Start: Upload release to BOSH Director\n\n```bash\nbosh -e vbox ur https://github.com/cloudfoundry-community/nginx-release/releases/download/1.21.6/nginx-release-1.21.6.tgz\n```\n\n#### 0.2 Quick Start: deploy\n\n(This assumes you're in the `~/workspace/nginx` directory cloned in a previous step):\n\n```bash\nbosh -e vbox -d nginx deploy manifests/nginx-lite.yml\n```\n\n#### 0.3 Quick Start: test\n\nBrowse to \u003chttp://10.244.0.34/\u003e; you should see the following:\n\n![nginx_release_welcome](https://user-images.githubusercontent.com/1020675/27837760-14599acc-609b-11e7-8e1a-eb4d305be2b7.png)\n\n### 1. Post-deployment HTML content\n\nWe find it effective to set the\n[`pre_start`]((https://bosh.io/docs/pre-start.html)) property to populate the\nwebserver content. See\n[here](https://github.com/cunnie/deployments/blob/d47af699bf11c4b168abfb9d5119ecc6dfddc06f/etc/nginx.yml#L53-L67)\nfor an example (sslip.io).\n\nAlternatively, you may manually add the HTML content *after* successful deployment.\n\nWe recommend installing HTML content on the persistent disk, e.g.\n`/var/vcap/store/nginx/document_root/` so that subsequent redeploys\ndo not require re-installation of HTML content, i.e. the\n`nginx.conf` should have the following directive:\n\n```\nserver {\n  root /var/vcap/store/nginx/www/document_root;\n```\n\n## Notes\n\n#### 1. nginx Job Properties\n\n* `nginx_conf`: *Required*. This contains the contents of nginx's configuration\n  file, nginx.conf. Here is the beginning from a sample configuration:\n  ```yaml\n    nginx_conf: |\n      worker_processes  1;\n      error_log /var/vcap/sys/log/nginx/error.log   info;\n  ```\n\n* `ssl_key`: *Optional*, defaults to ''. This contains the contents of the\n  SSL key in PEM-encoded format. This is required if deploying an HTTPS webserver.\n  The key is deployed to the path `/var/vcap/jobs/nginx/etc/ssl.key.pem` and\n  requires the following line in the `nginx_conf`'s *server* definition:\n\n  ```\n  ssl_certificate_key /var/vcap/jobs/nginx/etc/ssl.key.pem;\n  ```\n\n  Here is the beginning from a sample configuration:\n\n  ```yaml\n  ssl_key: |\n    -----BEGIN RSA PRIVATE KEY-----\n    MIIJKQIBAAKCAgEAyv4in6scMw3OkBlr++1OooLuZQKftmwGIO8puOj6lSH4H1LI\n  ```\n\n* `ssl_chained_cert`: *Optional*, defaults to ''. This contains the contents of the\n  SSL certificate in PEM-encoded format. This file will most likely contain\n  several chained certificates.  The certificate for the server should appear\n  at the top, followed by the intermediate certificate.  This property is\n  required if deploying an HTTPS webserver.  The certificate is deployed to the\n  path `/var/vcap/jobs/nginx/etc/ssl_chained.crt.pem` and requires the\n  following line in the `nginx_conf` *server* definition:\n\n  ```\n  ssl_certificate     /var/vcap/jobs/nginx/etc/ssl_chained.crt.pem;\n  ```\n\n  Here is the beginning from a sample configuration:\n\n  ```yaml\n  ssl_chained_cert: |\n    -----BEGIN CERTIFICATE-----\n    MIIGSjCCBTKgAwIBAgIRAOxg+vyhygau6bc2SAooL6owDQYJKoZIhvcNAQELBQAw\n  ```\n\n* `pre_start`: *Optional*, contains a pre-start script to execute,\nuseful for populating web content.\n\n## Developer Notes\n\nDeveloper notes, such as building and test a release, are available [here](docs/DEVELOPER.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry-community%2Fnginx-release","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudfoundry-community%2Fnginx-release","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry-community%2Fnginx-release/lists"}