Hi there,
You should look at “logs” folder under your tomcat installation. One of these files will exactly reports any errors that occurred in your installation.
*If you face " ERROR: out of shared memory; HINT: You might need to increase max_locks_per_transaction " error, uncomment #max_locks_per_transaction in …/data/postgresql.conf and set it as max_locks_per_transaction = 1024, restart PostgreSQL service and run Tomcat7.exe again.
1 Like
@Kenyuri is right. This more recent requirement is unfortunately not included in the guide, but is mentioned in a separate topic: DHIS2 404-not found error – DHIS2 Web Portal
And also mentioned in the Ubuntu version of the blog:
as well as in the DHIS2 manual:
1 Like
Thank you so much, Murod, Raphael and Knut. I very much appreciate your support.
I found the error messages to be not always helpful. I went down a rabbit hole based on the message that the dhis.conf file could not be found, even though I checked the file attributes and set the systems variable for it so many times in all variations imaginable, starting with the one in the setup guide. It didn’t make a difference.
I did set the transaction to 1024, Raphael, and followed the further instructions in the link you sent, Knut, but I still get the same 404 not found message when trying to access dhis2. I had high hopes the JRE_HOME setting would do the trick, since this one was new to me, but that didn’t work either. Is there perhaps another setting that might help? Or another help page?
Again, thank you all. I haven’t even started dhis2 yet, but I already love the community.
P.S. Later entries in the log file showed that the dhis.conf file is eventually found.
I used the following settings on my dhis2 instance on windows and it worked
Kindly navigate to C:\Program Files\PostgreSQL\12\data\postgresql.conf
Set the max_connections = 1000 , max_lock_per_transaction = 1024 .
If you encounter any problem kindly contact me on skype live:raphaelkenyuri so that I can assist where necessary.
Thank you for your reply, Raphael. I appreciate it.
The content of the file is from the installation guide. I stored it as dhis.conf (NOT .config) in the DHIS2 base folder on c drive.
Content:
connection.dialect = org.hibernate.dialect.PostgreSQLDialect
connection.driver_class = org.postgresql.Driver
connection.url = jdbc:postgresql:dhis2
connection.username = dhis
connection.password = dhis
connection.schema = update
encryption.password = abcd
Thank you for sharing your postgresql.conf file. I increased the max-connections from 100 to 1000 as suggested. I had already set max_locks_per_transaction to 1024. I also restarted pgAdmin4. The error message when accessing http://localhost:8080/dhis/ is unfortunately still the same.
Kindly try cross checking on everything using the guide on this link DHIS2 Installation on Windows Local Server – DHIS2 Web Portal
1 Like
Hi Johannes,
For myself (DHIS2 v2.33.5, Win10, Tomcat v9, PostgreSQL v12) I have to leave the command-line window open after executing the ‘startup.bat’ file in the Tomcat …\bin folder (e.g. after it displays the ‘INFO [main] org.apache.catalina.startup.Catalina.start Server startup in [157,311] milliseconds’ message) then it works ok accessing http://localhost:8080/dhis/, otherwise it doesn’t if I close it.
See if this works for you… I had some difficulty finding this out over the many times I’ve tried to install DHIS2 to Windows 
Hi Damien,
Thank you so much for your advise. I tried it on the Windows 7 and the Windows 10 system, and unfortunately, at least in my case, leaving the tomcat9.exe window open doesn’t make a difference. Worth a try though, so thank you again.
Best
Johannes
Hi @JWSchaefer did you ever resolve your issue? I’ve been having the same issue for two. months and a half now and the only way I’ve been able to make progress with a local installation of DHIS is to run an ubuntu vm but windows not yet…
@lillian1n2 Please see if the posts here might help you:
If you couldn’t find the solution, I’d recommend sharing details of what the issue is so that the sypport team can help you.
You could also try this if it’s helpful … it’s definitely working:
Hi! Yes I followed the guides available in many of the posts but wasn’t successful. The main issue was the last step where after I run apache, I get the 404 error when loading on the browser and I’d also notice that the tables wouldn’t appear under pgAdmin.
When running Apache, deployment a first completes without any error, up until the server startup message.
I was running the installation on Windows 10
PostgreSQL 13
JRE 8 and JDK 11
Apache 10.
DHIS 2.35.2 and 3 but also tried .34 and .33 i think
Actually, I tried installation on a different machine this week and was able to get a local instance running after numerous attempts and troubleshooting following the recommended installations guides,
The machine is running Windows 10.
PostgreSQL 12
JRE 8 (32.bit)
JDK 11
Apache 9 (32 bit)
DHIS 2.36.0
So notice that it was only this combination found through trial and error that led to a successful installation.
1 Like
I face the same error and i solve it
First :you should restart your PC
Second :start the service Tomcat9.exe as administrator (in bin folder in your tomcast folder) let it open every time don’t close it
then wait 5 minuts and open your browser and type the url :localhost:8080/dhis
that is it 
Note :don’t start Tomcat9w.exe never
1 Like
I just managed to get the right combination too through trial and error.
Ubuntu 20.
PostgreSQL 10.23
JDK 11
Apache Tomcat 8.5
DHIS 2.37.0
1 Like