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.10.x A Coruña ​ qgis Release
    qgis-rel-dev [1] Nightly build of the upcoming point release
    Long Term Release Repository 3.4.x Madeira LTR qgis-ltr Release
    qgis-ltr-dev [2] Nightly build of the upcoming point long term release
    Development 3.11 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 2019-11-22 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.10.x A Coruña ​ 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 3.4.x Madeira 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.11 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: 2019-11-22 12:00:00 UTC
Next release: 2020-02-21 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 9.x stretch [4]    
10.x buster   yes
sid unstable   yes
Ubuntu 19.04 disco   yes
18.04 (LTS) bionic yes yes
16.04 (LTS) xenial [4] [5] yes  
[4](1, 2) only up to 3.4 (3.6 requires Qt 5.9 and above)
[5]only with ubuntugis-unstable (3.4 requires GDAL2)
[6]3D requires Qt 5.9 and above

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 unstable:

deb     https://qgis.org/debian unstable main
deb-src https://qgis.org/debian unstable main

After that type the commands below to install QGIS:

sudo apt-get update
sudo apt-get install qgis qgis-plugin-grass

In case you would like to install QGIS Server, type:

sudo apt-get update
sudo apt-get install qgis-server

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-2019.gpg.key | gpg --import
gpg --fingerprint 51F523511C7028C3

Should output:

pub   rsa4096 2019-08-08 [SCEA] [expires: 2020-08-08]
      8D5A 5B20 3548 E500 4487  DD19 51F5 2351 1C70 28C3
uid           [unknown] QGIS Archive Automatic Signing Key (2019) <qgis-developer@lists.osgeo.org>

After you have verified the fingerprint you can add the key to apt with:

gpg --export --armor 51F523511C7028C3 | 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 51F523511C7028C3

Fedora

Get packages for any Fedora by typing:

sudo dnf install qgis python3-qgis 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

This repository also provides a copy of SAGA 2.3.1 compatible with Processing. It can be installed with the following commands:

sudo dnf install saga
Distribution Version QGIS version GRASS GIS version with 3D
Fedora 29 3.10 7.4 yes
30 3.10 7.6 yes
31 3.10 7.8 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 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

This repository also provides a copy of SAGA 2.3.1 compatible with Processing. It can be installed with the following commands:

sudo dnf install saga
Distribution Version QGIS version GRASS GIS version with 3D
Fedora 29 3.4 7.4 yes
30 3.4 7.6 yes
31 3.4 7.8 yes

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 28 3.9 7.4 yes
29 3.9 7.4 yes
30 3.9 7.6 yes
rawhide 3.9 7.6 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/

SUSE / openSUSE

Latest stable and LTR packages called qgis and qgis-ltr are available in the following repositoies:

Tumbleweed:

https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Tumbleweed/

Leap 15.1:

https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.1/

Leap 15.0:

https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.0/

Factory ARM:

https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Factory_ARM/

Factory PowerPC:

https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Factory_PowerPC/

SLE 15 SP1 Backports:

https://download.opensuse.org/repositories/Application:/Geo/SLE_15_SP1_Backports/

SLE 15 SP1 Backports debug:

https://download.opensuse.org/repositories/Application:/Geo/SLE_15_SP1_Backports_debug/

All packages include GRASS and Python support.

All openSUSE Geo repositoties can be found here:

https://download.opensuse.org/repositories/Application:/Geo/

Mandriva

QGIS stable

Current:

urpmi qgis-python qgis-grass

Slackware

QGIS stable

Packages on http://qgis.gotslack.org

ArchLinux

QGIS stable

Archlinux is available in official repository : https://www.archlinux.org/packages/community/x86_64/qgis/

Install with :

pacman -S qgis

QGIS LTR

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

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

Mac OS X / macOS

Official All-in-one, signed installers for for macOS High Sierra (10.13) and newer can be downloaded from the QGIS download page.

Alternative builds supporting macOS 10.11 El Capitan and later are available from kyngchaos.com

QGIS nightly release

A nightly updated standalone installer from QGIS master can be downloaded from here.

Old releases

Previous releases of the official installer can be downloaded from https://qgis.org/downloads/macOS/.

Previous releases of the kyngchaos installer can be downloaded from https://www.kyngchaos.com/software/archive/. The oldest installers support macOS 10.4 Tiger.

FreeBSD

QGIS stable

To install QGIS from binary packages type

pkg install qgis

Or to customize compilation options, you can build it from FreeBSD ports

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

QGIS LTR

To install QGIS from binary packages type

pkg install qgis-ltr

Or to customize compilation options, you can build it from FreeBSD ports

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

Flatpak

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

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.