Setting up OSM-HR Panoramax instance
Posted by Matija Nalis on 7 May 2026 in English. Last updated on 10 May 2026.So here are my experiences in installing Panoramax instance OSM-HR. I’ve made this from notes taken at a time, so hopefully I did not miss too much. Let me know if I did.
There are several ways to install, and I’ve decided to go with docker compose, and with regular OSM Oauth2 login.
We bumped into few issues during the deployment, but we reported them at appropriate repos, and they were fixed so nobody should be bothered by them anymore. Please do the same if you bump into some of your own!
So mostly I followed official instructions here: https://docs.panoramax.fr/backend/install/tutorials/running_docker_osm_auth/
with some preparation first as outlined in: https://forum.geocommuns.fr/t/deploying-a-panoramax-instance-the-pre-flight-check-list/1892
and info about storage needs: https://forum.geocommuns.fr/t/storage-needs-for-a-panoramax-instance/3205
Hardware
First actual hard step was getting the appropriate hardware and place to host it; see that pre-flight check list for other things like checking the law etc.
http://openit.hr/ kindly donated the hardware, and https://carnet.hr/ the place and Internet to host it. Much thanks to them!
We got quite a beast: 4U Super-Micro cse-847 server with 2 * Xeon E5-2680v2 (40 CPU threads @ 2.80GHz), 256 GB DDR3 RAM, 2x1TB SATA SSD, and 34x3TB SAS HDD (54 TB of usable HDD space after RAID6 partitioning), Nvidia Tesla P4
You can get with (much) lower specs, depending on your needs. But we have a good-hearted sponsor so yay!
Creating Oauth2 app
So firstly, I went to osm.org/, logged in, clicked on menu / “My account” / “Oauth 2 Applications” / “Register new application” and created Oauth2 application as described on: https://docs.panoramax.fr/backend/install/tutorials/running_docker_osm_auth/#creating-our-osm-oauth2-client
“Name” was set to Panoramax HR and “Redirect URIs” to https://panoramax.osm-hr.org/api/auth/redirect