This repository has been archived by the owner. It is now read-only.
No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Openshift Nginx Cartridge

Welcome to a life where nginx is possible on openshift.

This cartridge allow you to create a scalable nginx application, defaulting to using nginx version 1.9.12. Combine this with the boekkooi PHP cartridge and you have a scalable application using the latest versions.

Just create your app using:

rhc create-app myapp

If you want to install a specific nginx version you can add --env OPENSHIFT_NGINX_VERSION=<version> to the command. For example to install nginx 1.8.0 you can use:

rhc create-app myapp --env OPENSHIFT_NGINX_VERSION=1.8.0


Currently this cartridge has the following versions:

  • 1.11.1
  • 1.10.1
  • 1.9.12
  • 1.9.9
  • 1.8.0
  • 1.7.10
  • 1.6.2

If you need another version you can compile it yourself and submit a PR to get it integrated.

Compiling a new version

To compile a new version you will first need a openshift application.

rhc create-app nginx

Now clone the repository and create a nginx folder. Now copy the usr/compile directory from this repository. Now set the versions you need to compile in the nginx/compile/versions file. Commit and push the application repository.

SSH into you app and go to the compile folder (cd ${OPENSHIFT_REPO_DIR}/nginx/compile) and start compiling by running the following command:


Once compiling is done you can download the nginx-{version}.tar.gz from you application. Place the archive into the openshift-cartridge-nginx/usr folder. Last but not least edit the openshift-cartridge-nginx/manifest.yml and add the versions.

(Make sure you have Git LFS installed.) Now commit and push to your openshift-cartridge-nginx repo and create a PR.

To use your own fork make sure you change LFS_ENDPOINT in openshift-cartridge-php/bin/setup and use:

rhc cartridge add -a myapp<user>/openshift-cartridge-nginx