How to obtain QGIS?
QGIS is freely available on Windows, Linux, MacOS X, BSD, and Android.
We recommend installing the packages of the released software.
To evaluate the upcoming release and to allow non-developers to support development we also provide testing packages (note the warning).
In the feature frozen phase preceding a release (see Release schedule) these packages are effectively pre-releases, which we strongly urge users to test.
For Windows installers please go to The main installers page.
For new users we recommend the standalone installers.
For more advanced QGIS users you can use OSGeo4W packages, which make it possible to install several versions in parallel.
The OSGeo4W repository contains a lot of software from OSGeo projects. QGIS and all dependencies are included, along with Python, GRASS, GDAL, etc. The installer is able to install from internet or just download all needed packages beforehand. The downloaded files are kept in a local directory for future installations. Steps are:
Select Advanced Install,
navigate to the Desktop section
and pick one or more of the following packages:
| Release | Version | Package | Description |
|---|---|---|---|
| Latest Release | 3.4.x Madeira (new LTR) | qgis | Release |
| qgis-rel-dev [1] | Nightly build of the upcoming point release | ||
| Long Term Release Repository | 2.18.x Las Palmas (old LTR; EOL) | qgis-ltr | Release |
| qgis-ltr-dev [2] | Nightly build of the upcoming point long term release | ||
| Development | 3.5 master | qgis-dev [3] | Nightly build of the development version |
| [1] | Latest release nightlies SHA: 32 bit, 64 bit |
| [2] | Latest long-term release nightlies SHA: 32 bit, 64 bit |
| [3] | Master nightlies SHA: 32 bit, 64 bit |
For users that cannot use OSGeo4W for some reason or just prefer it there is also a weekly snapshot of qgis-dev from OSGeo4W as standalone installer (taken on monday). In the feature freeze phase that also acts as release candidate.
Note the warning.
Note
Don’t blindly do a full install of OSGeo4W. Only install QGIS and maybe other components you like. Dependencies will be included automatically. A full install pulls in components that require third party additions, which need to be installed manually. These components render the installation unusable without those additions.
Most linux distributions split QGIS into several packages; you’ll probably need qgis and qgis-python (to run plugins). Packages like qgis-grass (or qgis-plugin-grass), qgis-server can be skipped initially, or installed only when you need them.
Below you find instructions to install per distribution. For most distro’s there are instructions to install QGIS stable and instructions to install a cutting edge QGIS testing build (note the warning).
Default Debian and Ubuntu software repositories often hold older versions of QGIS.
To have newer versions, you have to add alternative software repositories, by adding one of the deb-lines below to your /etc/apt/sources.list file.
Our main repository contains multiple lines of packages for several versions of Debian and Ubuntu based on the dependencies the individual distributions provide.
For Ubuntu we also have extra packages in a separate repository that are based on ubuntugis, which holds more uptodate versions of other GIS packages than Ubuntu itself. If you want those you also need to include ubuntugis-unstable ppa in your /etc/apt/sources.list file (see ubuntugis documentation).
Note
The release packages are only produced once shortly after a new version has been released. As unstable, not yet released debian versions (testing) and ubuntugis-unstable can have library changes the packages might sooner or later be broken for these targets, when the development in debian, ubuntu or ubuntugis-unstable moves on and their packages used as dependencies in qgis change. In that event you can either
Lines of packages:
| Release | Version | Description | Repository |
|---|---|---|---|
| Latest Release | 3.4.x Madeira (new LTR) | Release for Debian and Ubuntu | https://qgis.org/debian https://qgis.org/ubuntu |
| Release with ubuntugis-unstable dependencies | https://qgis.org/ubuntugis | ||
| Nightly build of upcoming point release for Debian and Ubuntu | https://qgis.org/debian-nightly-release https://qgis.org/ubuntu-nightly-release | ||
| Nightly build of upcoming point release with ubuntugis-unstable dependencies | https://qgis.org/ubuntugis-nightly-release | ||
| Long Term Release Repository | 2.18.x Las Palmas (old LTR; EOL) | Release for Debian and Ubuntu | https://qgis.org/debian-ltr https://qgis.org/ubuntu-ltr |
| Release with ubuntugis-unstable dependencies | https://qgis.org/ubuntugis-ltr | ||
| Nightly build of upcoming point release for Debian and Ubuntu | https://qgis.org/debian-nightly-ltr https://qgis.org/ubuntu-nightly-ltr | ||
| Nightly build of upcoming point release with ubuntugis-unstable dependencies | https://qgis.org/ubuntugis-nightly-ltr | ||
| Development Version | 3.5 master | Nightly build for Debian and Ubuntu | https://qgis.org/debian-nightly https://qgis.org/ubuntu-nightly |
| Nightly build with ubuntugis-unstable dependencies | https://qgis.org/ubuntugis-nightly |
Supported distribution versions:
| Distribution | Version | Codename | Also available based on ubuntugis-unstable dependencies? | with 3D [6] |
|---|---|---|---|---|
| Debian | 8.x | jessie [4] | ||
| 9.x | stretch | |||
| 10.x | buster | yes | ||
| sid | unstable | yes | ||
| Ubuntu | 18.04 | bionic | yes | yes |
| 17.10 | artful | yes | ||
| 16.04 (LTS) | xenial [5] | yes | ||
| 14.04 (LTS) | trusty [4] | yes |
| [4] | (1, 2) only up to 2.18 LTR |
| [5] | 3.0 and above only available with ubuntugis-unstable (plain xenial lacks GDAL2) |
| [6] | only with Qt >= 5.9 |
Add the lines for one of the repositories to your /etc/apt/sources.list:
deb *repository* *codename* main
deb-src *repository* *codename* main
Example latest release for Debian stretch:
deb https://qgis.org/debian stretch main
deb-src https://qgis.org/debian stretch main
After that type the commands below to install QGIS:
sudo apt-get update
sudo apt-get install qgis python-qgis qgis-plugin-grass
In case you would like to install QGIS Server (note that it’s not a common practice to install both client and server applications on the same machine), type:
sudo apt-get update
sudo apt-get install qgis-server python-qgis
Note
Please remove all the QGIS and GRASS packages you may have installed from other repositories before doing the update.
In case of keyserver errors add the qgis.org repository public key to your apt keyring, type:
wget -O - https://qgis.org/downloads/qgis-2017.gpg.key | gpg --import
gpg --fingerprint CAEB3DC3BDF7FB45
Should output:
pub 2048R/BDF7FB45 2017-08-16 [expires: 2019-08-16]
Key fingerprint = 61E0 A086 749E 463E DE50 2255 CAEB 3DC3 BDF7 FB45
uid QGIS Archive Automatic Signing Key (2017) <qgis-developer@lists.osgeo.org>
sub 2048R/E959BBCF 2017-08-16 [expires: 2019-08-16]
After you have verified the fingerprint you can add the key to apt with:
gpg --export --armor CAEB3DC3BDF7FB45 | sudo apt-key add -
Alternatively you can download the key from a keyserver and add the key to apt in one go (without manual fingerprint verification):
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key CAEB3DC3BDF7FB45
Get packages for any Fedora by typing:
sudo dnf install qgis qgis-python qgis-grass qgis-server
Default Fedora software repositories often hold older versions of QGIS.
To have newer versions, you have to add alternative software repositories based on the version you want to install (stable, LTR or testing).
Enable the repository:
sudo dnf copr enable dani/qgis
After that type the commands below to install QGIS:
sudo dnf install qgis python3-qgis qgis-grass
In case you would like to install QGIS Server (note that it’s not a common practice to install both client and server applications on the same machine), type:
sudo dnf install qgis-server python3-qgis
| Distribution | Version | QGIS version | GRASS GIS version | with 3D |
|---|---|---|---|---|
| Fedora | 27 | 3.4 | 7.4 | yes |
| 28 | 3.4 | 7.4 | yes | |
| 29 | 3.4 | 7.4 | yes |
More information are available at https://copr.fedorainfracloud.org/coprs/dani/qgis/
Enable the repository:
sudo dnf copr enable dani/qgis-ltr
After that type the commands below to install QGIS:
sudo dnf install qgis python2-qgis qgis-grass
In case you would like to install QGIS Server (note that it’s not a common practice to install both client and server applications on the same machine), type:
sudo dnf install qgis-server python2-qgis
This repository also provides a copy of SAGA compatible with QGIS 2.18. It can be installed with the following commands:
sudo dnf install saga python2-saga
| Distribution | Version | QGIS version | GRASS GIS version | SAGA version |
|---|---|---|---|---|
| Fedora | 27 | 2.18 | 7.4 | 2.3.1 |
| 28 | 2.18 | 7.4 | 2.3.1 |
More information are available at https://copr.fedorainfracloud.org/coprs/dani/qgis-ltr/
Enable the repository:
sudo dnf copr enable dani/qgis-testing
After that type the commands below to install QGIS:
sudo dnf install qgis python3-qgis qgis-grass
In case you would like to install QGIS Server (note that it’s not a common practice to install both client and server applications on the same machine), type:
sudo dnf install qgis-server python3-qgis
| Distribution | Version | QGIS version | GRASS GIS version | with 3D |
|---|---|---|---|---|
| Fedora | 27 | 3.5 | 7.4 | yes |
| 28 | 3.5 | 7.4 | yes | |
| 29 | 3.5 | 7.4 | yes | |
| rawhide | 3.5 | 7.4 | yes |
Testing builds are updated on a weekly basis. More information are available at https://copr.fedorainfracloud.org/coprs/dani/qgis-testing/
Try the ELGIS repository: http://elgis.argeo.org/
Note
ELGIS requires the EPEL repo enabled, see http://wiki.osgeo.org/wiki/Enterprise_Linux_GIS#Note_about_Fedora.2C_ELGIS_and_EPEL
Latest stable openSUSE package called qgis is available for 13.1, 13.2, Leap_42.1, Leap_42.2 and Tumbleweed (32 and 64bit). Add the following repository to your installation manager, where <VERSION> is for example ‘openSUSE_Tumbleweed’.
https://download.opensuse.org/repositories/Application:/Geo/<VERSION>/
All packages include GRASS and Python support.
Long Term Release package for openSUSE called qgis-ltr is available for 13.1, 13.2, Leap_42.1, Leap_42.2 and Tumbleweed (32 and 64bit). Add the following repository to your installation manager, where <VERSION> is for example ‘openSUSE_Tumbleweed’.
https://download.opensuse.org/repositories/Application:/Geo/<VERSION>/
All packages include GRASS and Python support.
A regularly updated development package from qgis master called qgis-master is available for 13.1, 13.2, Leap_42.1, Leap_42.2 and Tumbleweed (32 and 64bit). Add the following repository to your installation manager, where <VERSION> is for example ‘openSUSE_Tumbleweed’.
https://download.opensuse.org/repositories/Application:/Geo/<VERSION>/
All packages include GRASS and Python support.
Packages on http://qgis.gotslack.org
Archlinux is available in official repository : https://www.archlinux.org/packages/community/x86_64/qgis/
Install with :
pacman -S qgis
Qgis Long Term Release is available in AUR (Arch User Repository).
Install with yaourt or other package manager which support AUR :
yaourt -S qgis-ltr
For bugs and other behaviour, read comments here : https://aur.archlinux.org/packages/qgis-ltr/
Qgis testing is available in AUR (Arch User Repository).
Install with yaourt or other package manager which support AUR :
yaourt -S qgis-git
For bugs and other behaviour, read comments here : https://aur.archlinux.org/packages/qgis-git
Installation instructions are in the ReadMe on the disk image. Downloads are on the QGIS download page.
The current QGIS package uses the python.org Python 3.6, at least version 3.6.5, the “macosx10.9” build - other distributions are not supported. Install packages in the numbered order. Especially note that Python must be installed before the GDAL Complete package and QGIS, else the GDAL and other needed Python modules will not be installed.
The stable package uses the system Python 2.7 - other distributions are not supported. It also requires the NumPy and Matplotlib packages on the disk image. Install packages in the numbered order. If an older major version is being upgraded (2.16 or older), delete QGIS.app from your Applications folder before installing this version.
Other Python modules for plugins to use are available from kyngchaos.com.
A standalone installer is available at https://lutraconsulting.github.io/qgis-mac-packager/.
There is an experimental QGIS flatpak for QGIS Stable available.
For general Linux Flatpak install notes, see https://flatpak.org/setup/
QGIS on Flathub: https://flathub.org/apps/details/org.qgis.qgis
To install:
flatpak install --from https://flathub.org/repo/appstream/org.qgis.qgis.flatpakref
Then to run:
flatpak run org.qgis.qgis
To update your flatpak QGIS:
flatpak update
Flathub files: https://github.com/flathub/org.qgis.qgis
There is an experimental version available on google play store.
https://play.google.com/store/apps/details?id=org.qgis.qgis
Warning
There is currently no support for Android 5. Best support is given for Android 4.3 and 4.4.x. This is a direct port of the QGIS desktop application. It is only slightly optimized for touch devices and therefore needs to be carefully evaluated for its suitability in day-to-day use. There are other apps available which are designed and optimized specifically for touch devices.
Warning
QGIS testing packages are provided for some platforms in addition to the QGIS stable version. QGIS testing contains unreleased software that is currently being worked on. They are only provided for testing purposes to early adopters to check if bugs have been resolved and that no new bugs have been introduced. Although we carefully try to avoid breakages, it may at any given time not work, or may do bad things to your data. Take care. You have been warned!
Refer to the INSTALL guide on how to build and install QGIS from source for the different platforms.