How to run OpenDocMan inside Docker

Running an OpenDocMan Document Management System Inside a Docker Container

We are pleased to announce our first release of OpenDocMan on Docker, a containerized deployment for OpenDocMan that utilizes the fantastic Docker container system. With this new method of deployment you can eliminate all of the server set up and just get to running OpenDocMan inside Docker right away . As long as you can get a local Docker server up and running (very easy!) you can deploy our docker container to your server in seconds and have a fully functional OpenDocMan installation.

What Is Docker?

Docker is a system that provides “containerized” deployments of applications. If you want to know more about it you should visit this page: What Is Docker?

Why don’t I just install OpenDocMan the old way?

Getting an OpenDocMan server up and running from the source code can be straightforward for those with some experience with setting up web servers. Unfortunately, even experienced users can have issues with their server environment that prevent them from being able to use OpenDocMan. We also have plenty of potential users who would like to use OpenDocMan but do not have the resources to properly set up a web server. We want to help anyone in that situation. With this new containerized method of installation we completely eliminate the web server setup. If you can create a new Linux server in the cloud (or locally), you can run OpenDocMan inside Docker and have an open source document management system running in minutes (or seconds if your real snappy!).

Ok, I will give it a go, what next?

The first thing you need to do is make sure you have a running MySQL server with an OpenDocMan database created and a username/password to access it. This OpenDocMan Docker we are using for this tutorial is just the code and the web server. The database is not part of the container. You will then need to decide on where you want to install your Docker server. A Docker server runs on either Linux, or by using a tool called Boot2Docker for Mac which will emulate a Linux server on your Mac for testing/development purposes. The easiest way to get started is to utilize a cloud server company that can give you a Docker server with a click of a button. We have found Digital Ocean to be a good, inexpensive provider for turn-key Docker servers. Once you have your docker server running….

I have the Docker server up, lets do this!

Ok, the hard part is out of the way. There is a decision you need to make. You can:

1) Checkout our github repository containing our Docker build files and “build” an image to use
Or
2) Download our OpenDocMan image directly from our Docker hub repository

If you think you might be customizing the installation you will be better of running from the github repository. If you just want to get going quickly it would be best to start with our Docker Hub repository.

Running OpenDocMan from a Dockerfile

This method of building the OpenDocMan application from a build file will allow you to customize anything needed for your particular environment. To get your document management server going:

  1. Login to your docker server
  2. Make sure you have “git” installed on the server. If not, use either apt-get or yum to install it
    1. apt-get install git
    2. yum install git
  3. Now you will clone our OpenDocMan docker build repository
    1. git clone https://github.com/opendocman/docker-opendocman-minimal.git ./docker-opendocman-minimal
  4. Now lets build the image
    1. mkdir /var/odm_data
    2. cd docker-opendocman-minimal
    3. docker build –rm –tag=”docker-opendocman-minimal” .   (don’t forget the dot)
    4. docker images
  5. We have an image now, we want to actually “run” it on our Docker server
    1. docker run -d -p 80:80 -v /var/odm_data:/var/www/odm_data docker-opendocman-minimal
    2. docker ps
  6. Now that its up and running you should be able to visit your servers IP in your browser and be present with the installation page

Running OpenDocMan from a Docker Hub Image

This way of running OpenDocMan Docker image will allow you to skip the build process entirely and just “run” the image in your Docker server

  1. Login to your docker server
  2. Run the OpenDocMan Docker image
    1. mkdir /var/odm_data
    2. docker run -d -p 80:80 -v /var/odm_data:/var/www/odm_data stephenlawrence/opendocman-www:minimal
    3. docker ps
  3. You can now visit your server IP and you will see the installation page

I think its running, what do I do now?

Well, you can login to the container and poke around, or you can visit your Docker servers’ IP address and you should see your OpenDocMan installer.

Whats next?

We are going to be putting together a MySQL container that will come pre-installed with a running OpenDocMan database, ready-to-use with your OpenDocMan application container. Stay Tuned!

 

0 Comments

OpenDocMan v1.2.9 Released

v1.2.9 includes bug fixes as well as new features. The release includes database updates.

#182 Details page is showing reviewer comments instead of the file comment
#181 Site settings page doesn’t show error messages
#180 Add a max_query limit to the site settings to improve performance. This should help users who have a large amount of files and noticed slow page loads on the main page, especially admin users. We will no “limit” the number of files that show up in the normal file list page, but have no limit for search results. This limit will be set in the Admin->Site Settings->max_query setting with a default to 500.
#179 Clean up the db install/upgrade to make it more clear
#177 Login page – text has no left margin
#176 Missing columns int the database.sql file
#87 Missing slash on the end of the dataDir (Site Settings Page) causes problems

0 Comments

OpenDocMan v1.2.8.1 Released

This release includes bug fixes and enhancements. No database changes.

#175 – Admin setting doesn’t stick
#174 – Permissions Links inconsistent between themes
#173 – add image/svg as standard document type

#171 – Feature – Add Bengali Language
#157 – Add DWG to mimetypes.php

2 Comments

OpenDocMan v1.2.8 Released

Version 1.2.8 of OpenDocMan has been release. This release includes a new limited-user feature as well as a fix for some Windows file path issues. This release contains database changes.

The limited-user feature allows the administrator to enable/disable access to the “Add” and “Check-In” areas for specific users. This also removes the menu items.

2 Comments

Test

test

0 Comments

OpenDocMan v1.2.7.3 – Release Notes

OpenDocMan v1.2.7.3 has been released which includes a security fix, a bug fix for sub-select UDF fields, and the arabic language.

You can download the latest release from Here

0 Comments

OpenDocMan v1.2.7.2 Released

OpenDocMan v1.2.7.2 has been released which includes security fixes. This release does not include any database changes. All users are strongly urged to update to the latest version.

Changes included in this release:

SQL injection issue

You can download the latest version here.

5 Comments

OpenDocMan v1.2.7.1 Release

OpenDocMan v1.2.7.1 has been released which includes security and bug fixes. This release does not include any database changes. All users are strongly urged to update to the latest version.

Changes included in this release:

  • SQL injection issue
  • Security updates
  • #148 – Permission settings disappear when more than 10 users/departments
  • #139 – Assign to department is showing for non-admin users
  •  #138 – Added Romanian translation
  • #137 – Missing language translations

The latest version can be downloaded here.

1 Comment

OpenDocMan DMS Release 1.2.7

OpenDocMan 1.2.7 as been released. This release does not include any database changes but it does include a change to the Department/User permissions section on the Add and Edit File pages as well as other bug fixes.

Changes included in this release:

  • #136 – File details not showing last reviewer comment
  • #132 – Use full PHP opening tags rather than short ones which may be unsupported
  • #131 – Remove all short tags
  • #125 – EDIT option issue
  • #83 – User Defined Fields – Filter isn’t working also in 1.2.6.5 version
  • #79 – Re-factor the add/edit pages to use a more straightforward UI enhancement
  • #67 – User Defined Fields – Filter-by not working bug
Download the latest release

 

1 Comment

OpenDocMan 1.2.6.8 Release – Change Log

This release is a minor update with security fixes, bug fixes, and language file changes. No database changes.

Changelog (10/16/2013) 1.2.6.8:

* 112: Add Czech Translation
* 122: Mime-Type Check Fails if function_exists(‘mime_content_type’) but returns null
* 126: Update spanish translation from 1.2.6.7
* 129: URL redirection security
* 130: Update Italian Translation from 1.2.6.7

0 Comments