web analytics

How to Install OpenDocMan on OpenShift

opendocman and openshift logo

OpenDocMan is a free and open source web-based document management system (DMS). OpenDocMan allows its user to quickly and easily create an online portal for documents management (actually any type of file could be uploaded to OpenDocMan) and start administering access and permissions for these files. What is unique about OpenDocMan is that it’s very simple to use just drag and drop files to your installation from your browser.

This guide will present a step by step tutorial on how to install OpenDocMan on OpenShift, the only skill you’ll need during the tutorial is your ability to use a web browser.


  1. A free OpenShift account, visit OpenShift website and register using your email, no credit card is required. 1 - create openshift account


  1. After registering; go to OpenShift home page and click on the “MY APPS” on the top of the screen.2 - open Openshift Account
  2. You’ll be directed to your login window and enter your credentials, you’ll be directed to a new window click on the blue “Create your first application now” link.3-create openshift application
  3. You’ll be directed to a window, type “PHP, MySQL” in the search field, and select the application shown below in the screenshot. 2 - concrete5 on openshift
  4. You’ll be directed to a new window, in the public URL; type the name of the project/application name (e.g. OpenDocMan, DocStorage, etc.) in the first space and the domain name (it’s not your real domain name, just any identification name e.g. NickName, YourName) in the second space.5 - openshift application name
  5. Under the public URL, there’s the source code slot, just copy and paste the following  link “https://github.com/opendocman/opendocman.git”
  6. Leave everything as it’s and click on “Create Application” tab at the end of the page.3 - concrete5 on openshift
  7. You shall be directed to a new window where you shall find all of your “MySQL” credentials.4 - concrete5 on openshift
  8. You’ll be directed to the main window again and it’s time to go to your ” portal” and start the installation process, to do that simply click on the blue link at the top of the screen (that’s your URL).1 - DocMan on OpenShift
  9. You’ll be directed to the “OpenDocMan” installation window, the first window will have a warning message just ignore it and click on the create a configuration file tab. 2 - DocMan on OpenShift
  10. You’ll be directed to a new window, where you should enter some information like “password, database username, database password”, you can get this data from step “7”, you’ll also have to create and fill your login admin password.3 - DocMan on OpenShift
  11. In that window,  you should provide your database credentials, there’s a small trick here which is getting your database Host Server, the easiest way to do so is to return to your application (step 8) and click on the small arrow at the phpMyAdmin tab.
  12. A new window will pop up , copy the number shown in the screenshot below. 6 - thinkup database host
  13. Paste that number in the database host field in the OpenDocMan installation, then fill the remaining fields using your database credentials that you can find in your application.
  14. You’ll then be directed to a new window where you should start the installation, click on “run the installation” tab.
  15. In this new window; you should install the database, just click on the tab at the bottom of the window.5 - DocMan on OpenShift
  16. You’ll be directed to a new window with your admin username and password,  write a note with them and then log into your website again using the link in step 8, you can access the site settings using the “here” link, though that’s not required.6 - DocMan on OpenShift
  17. When you log in again to your portal you’ll be prompted by your admin window which should look like the one below.

10 - DocMan on OpenShift

Now, you’ve a fully functional OpenDocMan DMS portal running for free on OpenShift.