QGIS Installers

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.

Windows

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:

  • Download OSGeo4W Installer (32 bit or 64 bit) and start it

  • Select Advanced Install,

  • navigate to the Desktop section

  • and pick one or more of the following packages:

    Release Version Package Description
    Latest Release 3.2.x Bonn ​ qgis Release
    qgis-rel-dev [1] Nightly build of the upcoming point release
    Long Term Release Repository 2.18.x Las Palmas LTR qgis-ltr Release
    qgis-ltr-dev [2] Nightly build of the upcoming point long term release
    Development 3.3 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.

Linux

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).

Debian/Ubuntu

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

  • move to a stable debian version and use the released packages for it,
  • wait for the next point release (due 2018-10-26 12:00:00 UTC), which happens every month and will include the updated dependencies,
  • switch to a nightly repository (available for the two release branches and master) whose packages are rebuild on regular basis and will also pickup the updated dependencies automatically or
  • build your own set of packages (see INSTALL).

Lines of packages:

Release Version Description Repository
Latest Release 3.2.x Bonn ​ 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 LTR 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.3 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
Next point release: 2018-10-26 12:00:00 UTC
Next release: 2018-10-26 12:00:00 UTC
(more dates see Release Schedule on Road Map)

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    
sid unstable    
Ubuntu 18.04 bionic   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 including Qt 3DExtras (the latter is currently not included in Debian)

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

Fedora

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).

QGIS stable

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.2 7.4 yes
28 3.2 7.4 yes

More information are available at https://copr.fedorainfracloud.org/coprs/dani/qgis/

QGIS LTR (Long Term Release)

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/

QGIS testing

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.3 7.4 yes
28 3.3 7.4 yes
rawhide 3.3 7.4 yes

Testing builds are updated on a weekly basis. More information are available at https://copr.fedorainfracloud.org/coprs/dani/qgis-testing/

RHEL, CentOS, Scientific Linux

QGIS 1.8

Try the ELGIS repository: http://elgis.argeo.org/

openSUSE

QGIS stable

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.

QGIS LTR (Long Term Release)

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.

QGIS testing

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.

Mandriva

QGIS stable

Current:

urpmi qgis-python qgis-grass

Slackware

QGIS stable

Packages on http://qgis.gotslack.org

ArchLinux

Archlinux users are encouraged to use the Arch User Repository (AUR).

Information about available versions, bugs and archlinux specific instructions can be found at: https://aur.archlinux.org/packages/?O=0&K=qgis

Mac OS X / macOS

Installation instructions are in the ReadMe on the disk image. Downloads are on the QGIS download page.

QGIS current

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.

QGIS stable

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.

FreeBSD

QGIS stable

To compile QGIS from binary packages type

pkg install qgis

QGIS testing

To compile QGIS from sources in FreeBSD you need to type

cd /usr/ports/graphics/qgis
make install clean

Note the warning.

Android

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.

QGIS Testing warning

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!

Installing from Source

Refer to the INSTALL guide on how to build and install QGIS from source for the different platforms.