Capture app not opening after upgrading to 2.42.4

Support - Assistance technique
1

Dear team,

We upgraded two DHIS2 instances from 2.39.x to 2.42.4. While every other thing seems to work well, the Capture app failed to open as in the screen shot below. Unfortunately, nothing in catalina.out indicated the reason for this failure. Kindly help.

image
image1884×992 22.9 KB

2

Hi Siaka,

Welcome back to the DHIS2 Community of Practice! :tada:

Please make sure to update all the bundled apps (specifically, Dashboard app, Capture app, and Data Visualizer app)… then I would recommend clearing your browser cache and using the ‘reload apps + clear application cache’ in the Data Administration app.

Finally, would you please try again by testing in the Guest mode of your browser, and before you open the app, please keep the Network tab in the DevTools (F12) open. You will see requests in the Network tab, could you take a screenshot of that as well as the Console log for the details?

Thanks!

3

Thanks @Gassim for your prompt response. I will implement your guide and provide feedback

4

Hi @Gassim ,
I tested these suggestions, and I’m still getting the same error as Siaka showed in his screenshot. I do see an error Key ‘ruleEngine’ not found in namespace ‘capture’", but I’m not sure that is the reason the app isn’t opening. Do you have any other suggestions?

Thanks!

5

Thanks @smomoh and @kstankevitz !

It will help a lot if we could get more debugging info like the network requests that are failing and the console log errors please..

Additionally, if you can actually reproduce this on any of the play.dhis2.org instances then sharing the steps to do so would be of great help.

Thank you!

6

@smomoh , can you please provide more information? I doubt we can reproduce it on play, as it is related to an upgrade.

7

Hi @kstankevitz,

Have you tried downgrading the Capture app version (eg one from February 2026) to see if the app loads then? Just to rule out whether it was something introduced in recent app versions.

What app version are you currently using?

Can you also increase the version number for the program in Maintenance/Metadata Management App? This is a way to clear the cache properly.

Let me know if any of that works!

Best,
Karoline

8

Hi all,

Thanks for your effort on this. We have resolved the issue, and the Capture is loading correctly now. We discovered that an enrollment forms in one of the trackers was not properly setup, likely missing some metadata because it was imported from another system. We deleted the form, recreated it and the Capture app started loading normally. @Gassim, @Karoline, we appreciate your efforts in addressing this issue.

9

Thank you @smomoh for the update! Great to know that recreating with all the proper metadata the form fixed the issue. :clap: