Skip to content
This repository has been archived by the owner. It is now read-only.
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit 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
You can’t perform that action at this time.