• Docker Advice

  • Problems with installing OpenKM? No problemo, the solution is closer than you think.
Problems with installing OpenKM? No problemo, the solution is closer than you think.
Forum rules: Please, before asking something see the documentation wiki or use the search feature of the forum. And remember we don't have a crystal ball or mental readers, so if you post about an issue tell us which OpenKM are you using and also the browser and operating system version. For more info read How to Report Bugs Effectively.
 #43956  by tcconsulting
I'm wanting to run OpenKM as a Docker container, but I'm not finding a lot of documentation. So I have a few questions I hope someone can help with:

1. I've tried to pull down what looks like the official image, openkm/openkm, from Docker Hub, but I get a "manifest for openkm/openkm:latest not found" error. The Docker Hub page says there have been 22 pulls, so I don't know if I'm just doing something wrong. I've pulled down tons of other images and this is the first time I've run across this message when pulling from Docker Hub.

2. There are several images for OpenKM on Docker Hub made by various folks. Does anyone have a recommendation for any particular one?

3. The images I've looked at tend to be for the Community Edition, which makes sense. But I want to use the Professional Edition. Anyone know of a pre-built image of the Professional Edition, or will I have to build my own?

Thanks for any help of advice!
 #43985  by tcconsulting
Do you know when it will be available?

Also, will there be a professional version of it available?
 #44009  by pavila

Feel free to use it. It should work. It's my first public Docker container, so if you find any problem report it and I will try to fix it.

In this moment there is no plan for a Professional based Docker container, but it may be possible. First of all I want to ensure the Community container works properly.

 #44366  by tcconsulting
I still get an error message when I try to pull it down:

Error response from daemon: manifest for openkm/openkm:latest not found
 #44367  by pavila
Try with:
Code: Select all
$ docker pull openkm/openkm:6.3.3
 #44382  by tcconsulting
Worked fine this morning with just "docker pull openkm/openkm".

Thanks! I'll be trying it out today.
 #44386  by tcconsulting
Is there any chance of seeing the Dockerfile that builds it?

That would help if I extend it.
 #44412  by pavila
Can't you simply extend this container? I'm not sure what do you want to do.
 #44885  by pschulz01

I have been able to run the image, but have had some issues along the way.
More documentation on how to use the docker image (openkm/openkm:6.3.3) would be very useful.

1. The service needs to be accessed via 'IP Address'. eg. http://IPADDRESS:8080
If I try and use the hostname (eg. http://hostname:8080) I get the following error, and nothing is displayed:

Popup in browser:- Error getting translations: No row with the given identifier exists: [com.openkm.dao.bean.Language#en-US]

Question: How do I setup access vi a hostname? What needs to be done? (other than DNS A or CNAME records?)

2. In order to make the container data persistent, I have created a docker volume for /opt/openkm
Question: Is this sufficient? Is this too much? Is there anywhere else that needs to be preserved between container restarts.

In particular, I am interested in the following:
- backup and restore of data (which directories?)
- the upgrade process for openkm
- service migration to other hardware. (eg. stop container, copy volumes, start container on new hardware)

3. I have created a 'docker-compose.yml' file
Code: Select all
version: "3"

    image: openkm/openkm:latest
    container_name: openkm
      - openkm-data:/opt/openkm
      - 8080:8080
    restart: always

Other Notes:
Other images and documentation
- obviouscap/openkm - https://github.com/obviouscap/openkm -version 6.3.2. Contains a Dockerfile which builds the openkm image.
- mcsaky/openkm - https://hub.docker.com/r/mcsaky/openkm/ - version 6.3.0, but suggests that http://yourserver.com:8080 can be used. Also contains a useful Dockerfile example.
 #46484  by just_me
Cool enough,

thank you. This helped me out, the docker-compose.yml.

I wanted to use docker-compose, but as a noob to this things, it was very helpful

But what i am wondering about: How do i get SSL encryption via https:// Link on openKM running on Port 8080?

Any advice for that?

Thanks and best
PS: Hostsystem runs a cert via letsencrypt, if i could use this with openKM, this would be brilliant, because it will be renewed each month on its own ...
 #47638  by styroteqe
Is the default okMadmin password for this container different from the one provided in the documentation?
 #47639  by pavila
The default "okmAdmin" password is "admin". I've just added this info to the Docker Hub page.
 #47657  by rbuick
I have run the docker image from https://hub.docker.com/r/openkm/openkm-ce/ (updated 13 days ago) on dockerhub, version 6.3.7 (build: 3fc09ed), which works fine on port 8080.
I would like to be able to run this on a secure port, but assigning an additional port 8443 doesn't display anything and comes back with 'connection timed out'.
Using the previous openkm/openkm docker image - no longer downloadable from - https://hub.docker.com/r/openkm/openkm/ - Version 6.3.6 (build: 87d181f) , worked fine on secure port 8443.
Any thoughts?
I wondered if the Dockerfile for this might be available?

About Us

OpenKM is part of the management software. A management software is a program that facilitates the accomplishment of administrative tasks. OpenKM is a document management system that allows you to manage business content and workflow in a more efficient way. Document managers guarantee data protection by establishing information security for business content.