DHIS2 starts support of official docker images

That’s great news. We are also using docker for our dhis2 implementation since last year. This is very helpful particularly for decentralized implementation. We are deploying server (NUC) with NixOS in the field and remotely (ssh) maintain the host and local dhis2 instance. We are using the data and metadata sync from field instance to the central instance. There were some challenges using docker specially with jvm memory. So far we have implemented dhis2 in 5 countries using docker.

5 Likes

Hi!

@Jasper_Timm,

Yes, dockerfile is available same as the rest of the code. You can find it here. You can see that docker build is multi-staged. We build WAR file in first stage and use that in the images we publish. Jenkins builds images every 20 minutes if any changes were made for versions starting from 2.30.

@Mohammad_Ullah,

Thanks for sharing, great to hear about your positive experience dockerising DHIS2 instance! If you get to try our images, please do not hesitate to give feedback or request features :slight_smile:

2 Likes

This is great news, however just wanted to find out from @Gintare and team if there are any plans to add some documentation in the implementations guide on setting up DHIS2 using docker?

3 Likes

Hi @haroont,

That’s a great suggestion! Right now we can’t recommend using our images in production as we still want to make few security improvements and hear from implementations who use docker successfully. When we make images ‘production-ready’, we will consider adding a section to the implementation guide. However, we will definitely add a guide to using our images to at least our docker-hub page soon. :slight_smile:

3 Likes

Beautiful :ok_hand:!! Love the progressive mentality, aligning DHIS2 with powerful emerging technologies. Keep us posted please :slightly_smiling_face:

4 Likes

So happy to hear DHIS2 is supporting Docker. I’m struggling to get DHIS2 up and operational for an NGO. Like @SDKAAA, I’m also wondering if there is any tutorials or plans to add documentation in the implementation guide as suggested by @haroont.

3 Likes

the implementer guide is enough for you to implement DHIS2… if you follow the instructions properly and have the right server specifications everything should work fine.

3 Likes

Hi @gjlisiak

As Gintare said, we will try to provide some guidance for Docker images at some point in the near future. At the moment we are preparing for the 2.33 release and so are a bit swamped with other priorities.

We will keep you all posted!

Kind regards,
Phil

3 Likes

Thanks Philip we appreciate the great work.

2 Likes

Hi @haroont, @gjlisiak and others.

As per your request, I wrote a small guide about how to use our docker images. You can find it here. I will edit my original post to include it as well.

Happy dockering!

6 Likes

Thank you

2 Likes

Hello Everyone, This is my first time to post here and I had been reading a lot of great topics around the community concerning DHIS2 installation, deployment etc. and with that, In behalf of NCP, I just like to share this simple dockerized DHIS2 (web and core versions) ec2dhis2docker | DHIS2 on AWS EC2 instance with Ubuntu18.04 64bit

4 Likes

Hello @dhec, So glad to have you here. Thank you for sharing this.

1 Like

Hi @dhec,

Thanks for sharing, your setup looks great! I had a quick look and I see that in your docker-compose.yml you use the old images, from dhis2/dhis2-web repository. This image repository is not maintained by DHIS2 core team and we can’t guarantee that it always has the latest version of DHIS2 and is working properly. I would recommend you to try the other repositories not marked as [Not maintained by DHIS2 team].

2 Likes

Thanks @Gintare,

Yeah, I just noticed today that there’s now a note on DHIS2 dockerhub that says it’s not a supported version, though I’ve included the supported DHIS2-core version (dhis2-core.yml) on the repository, I think I’ll set the Core version as default on docker-compose.yml moving forward and will try to test and put other supported docker images as well. We’ll keep you all posted.

2 Likes

Hi Everyone, just want to let everyone know that I’ve updated the following on our repository FYI:

  1. Updated readme/guide
  2. Made dhis2-core docker version as default on the docker-compose.yml file, the dhis2-web (unsupported version) is still available as dhis2-web.yml. this means that the minimum EC2 instance would be t2.small for it to work well.
  3. Added dhis2-core-dev.yml for those who would like to launch dev version (tested) to launch, just do docker-compose -f dhis2-core-dev.yml up -d
2 Likes

Thank @ Dhec for information

2 Likes

Amazing work @Gintare and team, thank you so much!

3 Likes

A post was split to a new topic: How to adjust the Data Set table

Type Status Report

Message /dhis/

Description The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.

Apache Tomcat/9.0.29

hey James. I was installing dhis 2 on windows what about this error?

1 Like