Skip to content
QGIS 3.4 and 3.6 Desktop running on Docker
QML Dockerfile Shell
Branch: 3.6
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
data/qgis34-docker/.local/share/QGIS/QGIS3/profiles Completed README Jan 11, 2019
docs README complete with comments, picture and a minimal Installation guide Jan 10, 2019
.gitignore Mar 21, 2019
Dockerfile v3.6.2 Apr 24, 2019
LICENSE Update Mar 27, 2019
build version 3.6 Mar 18, 2019 Mar 21, 2019 version 3.6 Mar 18, 2019

Image info Docker pulls

QGIS 3.x Desktop running on Docker

A full-fledge QGIS 3.x running on Docker.

Everything supported in the standard QGIS 3.x is ready out of the box: 3D views, Google Maps/Sat/Terrain integration, OSM, plugins etc. Preferences are retained across sessions, and the integration with your physical computer is seamless.

Automated build on Docker Hub for maximum reliability.

qgis_desktop_docker screenshot

Installation And Usage

This is the easiest and fastest way, since it downloads the image from DockerHub, you don't need to compile anything on your computer.

git clone
cd qgis_desktop_docker

#after the container is running (i.e. with the full GUI), you can optionally use the Command Line:

Build your own

If you instead feel like customizing something, you can build the image locally:

git clone
cd qgis_desktop_docker
#(Edit the Dockerfile or what you need)
. ./build



There are three exposed directories:

  1. /mnt/ext_home/ is mapped to your home directory (i.e. "~")
  2. /root/qgis34-files is the working files directory and is mapped to your computer's ~/qgis34-files
  3. /root/.local (the profile/preferences directory) maps to your computer's ~/.qgis34-docker. This allows to retain preferences, histroy, etc across different sessions.


Since the X11-unix is mapped directly (by the script), there should be no need to run the insecure xhost + command. However, should you get errors accessing the display, consider running:

xhost +

Brought to you by:

RafDouglas C. Tommasi C. - 2019

Released as GNU General Public License v3.0 - 2019

You can’t perform that action at this time.