Docker Compose 🐳

Development in the Docker Compose setup¶

Follow the Quickstart in README.md. Check if everything is running.

Info

To force reinstall GitHub dep qgis_server_light interface without complete rebuild:

docker compose exec georama bash -c '/opt/georama/venv/bin/pip install --force-reinstall --no-deps "git+ssh://git@github.com/opengisch/qgis-server-light.git@master#qgis_server_light"'

🔄 Live Code Reloading¶

The Docker setup mounts the local project code into the container (specifically the georama service). This enables hot reloading, meaning code changes are picked up without restarting the container.

🧠 IDE Integration (Container Interpreter)¶

If you use an IDE (e.g. PyCharm), you can point it to the Python interpreter inside the container: /opt/georama/venv This gives you full code intelligence and completion based on the container’s environment.

🧑‍💻 Using PyCharm with Docker Interpreter¶

🐳 Adjust the Dockerfile¶

Add comment marks to the line 48+49+50 in the Dockerfile as shown below:

#ENTRYPOINT ["/tini", "--", "make"]
#
#CMD ["serve-dev"]

Now run:

docker compose build
docker compose up -d

⚙️ Configure the Python Interpreter in PyCharm¶

Example

Specify the interpreter path as: /opt/georama/venv/bin/python

Example

🐞 Configure Run/Debug¶

Adjust the IP in the run/debug configuration to 0.0.0.0 and the port to 4242

Example

▶️ Start Debugging¶

Finally, you can now connect to the pycharm debugger

PyCharm Starting

PyCharm Running