This repo helps you install Isso on Openshift with a single click
Switch branches/tags
Nothing to show
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.

Isso Openshift Deployment Kit


This repo helps you installing Isso on Openshift with just one click.


There are three ways to perform installation, following is the method I prefer:

  • Install rhc(instructions), then run following, you will get an Open Shift instance installed with Isso:

      rhc create-app appname python-2.7 --from-code
  • Above step also clones Git repository of your Open Shift instance, in current directory. Make changes to the config file and push back to Openshift, it will be redeployed with new settings.

Alternative ways:

  • If you are using openshift web interface, pick Python 2.7 cartridge and provide url of this repo in Source Code field. Thats all, Isso will be installed in your Open Shift instance!
  • Now, from Open Shift App's main page, get it's Git address. Clone it your local machine and make changes to Isso config file. Do Git commit and push it back to Open Shift, it will be redeployed with new settings.

Another way is, fork the current repo and make changes to config file as desired. And now use either method #1 or #2. However you may end up pushing sensitive information to public repo. So, be careful.


  • Why dbpath in production.cfg is setup like that and uses relative path?

    Read this link to understand why database path is setup like that. TLDR; Everytime you make changes, the repo directory will be wiped clean and re-created and that's why Openshift provides specific location to store persistent data. The location of current running repo will be at ~/app-root/runtime/repo/ (check environment variable $OPENSHIFT_REPO_DIR) and location to store persistent data is at ~/app-root/data/ (check environment variable $OPENSHIFT_DATA_DIR).


Thanks to Martin Zimmermann (posativ) for awesome Isso. He also helped me during initial deployments and troubleshooting, answering my noobie questions. Also thanks to user cyrozap on official #isso IRC channel. An important part of code uses Custom Application example from Gunicorn documents.


The MIT License (MIT). Check LICENSE