Please note that these documents apply to OpenShift Online v2 only (accounts created before August 1st, 2016).
If you are using one of the OpenShift 3 products, please refer to documents available at

DIY Application Hosting

The diy cartridge provides a minimal, free-form scaffolding which leaves all details of the cartridge to the application developer.

Get started

  1. Add the framework of choice to your repo.

  2. Modify .openshift/action_hooks/start to start your application. The application is required to bind to $OPENSHIFT_DIY_IP:$OPENSHIFT_DIY_PORT.

  3. Modify .openshift/action_hooks/stop to stop your application.

  4. Commit and push your changes.

Repo layout

static/           Externally exposed static content goes here
    action_hooks/ See the Action Hooks documentation (1)
        start     Custom action hook used to start your application
        stop      Custom action hook to stop your application
1 Action Hooks documentation
Please leave the static directory in place (alter but do not delete) but feel free to create additional directories if needed.

Environment Variables

The diy cartridge provides the following environment variables to reference for ease of use:

Variable Name Purpose


The IP address assigned to the application


The port assigned to the the application

See the other Environment Variables that are available on OpenShift.