QGIS Installers ¶

QGIS is available on Windows, macOS, Linux, FreeBSD, OpenBSD, Android and iOS.

We recommend installing the Long Term Release (LTR) packages since our LTR versions undergo more rigorous testing before release and receive at least one year of bug fix updates.

See also the main installers page.

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 ¶

There are two options for installing on Windows:

Offline (Standalone) installers ¶

Standalone installers include everything QGIS needs in a single download. Once you have the installer, no internet is required to complete the installation. When a new release is available, you need to download the complete installer again in order to upgrade. For beginners, the standalone installer is probably the easiest way to install QGIS:

Due to their extensive size the optional projection grids were excluded from the default installer. QGIS will identify at runtime when grids are required for reprojection and ask for manual download.

For environments where that isn’t possible or inconvienient there are still standalone installers that include the grids. As of 4.0.1 the regular installer is 0.5 GiB, while the installer including all the grids is 1.2 GiB.

It’s also possible to add the grids later by using the included “OSGeo4W Setup” to install the proj-data package. Or to use the also included command line tool projsync to download grids for a given area.

The weekly snapshots of the nightly qgis-dev package of OSGeo4W are for users that cannot use OSGeo4W (see below) for some reason or just prefer standalone installers. In the feature freeze phase, these also act as release candidate installers.

Online (OSGeo4W) installer ¶

More advanced QGIS users should use OSGeo4W packages. This installer makes it possible to install several versions of QGIS in parallel and also to do much more efficient updates as only changed components are downloaded and installed with each new release.

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 and could also be used to install offline.

Installation steps are:

• Download OSGeo4W Installer and run it.

• Choose Express Install and select QGIS to install the latest release and/or QGIS LTR to install the long term release.

Alternatively, instead of doing the Express install, you can use the Advanced Install, navigate to the Desktop section and pick one or more of the following packages:

[1] Nightlies are debug builds (including debugging output that can be used by developers to better understand issues with the build).

[2] 4.0 marks the switch to Qt6. Earlier versions of QGIS were experimental with Qt6. Starting with 4.0 only Qt6 is supported.

The packages listed in the above table only install the necessary dependencies needed to run QGIS. Corresponding to those packages there are also meta packages with the suffix -full-free and -full. The -full-free contains additional optional dependencies that some popular (not included in the default QGIS install) plugins use. The -full includes everything from -full-free and also adds proprietary extensions like Oracle drivers, ECW and MrSID.

The Express installs reference the corresponding -full variant and the standalone installers are also made from these OSGeo4W package sets.

The -full-grids variants include the optional projection grids (ie. -full plus the proj-data package). The huge standalones are based on these.

Before installing any of the nightly builds note the warnings below.

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 installed when you need them.

Below you will find specific instructions 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 ¶

Quickstart ¶

Simply install the latest stable QGIS (4.2.x Belém do Pará) in your Debian or Ubuntu without having to edit config files.

First install some tools you will need for these instructions:

sudo apt install gnupg software-properties-common

Now install the QGIS Signing Key, so QGIS software from the QGIS repo will be trusted and installed:

sudo mkdir -m755 -p /etc/apt/keyrings  # not needed since apt version 2.4.0 like Debian 12 and Ubuntu 22 or newer
sudo wget -O /etc/apt/keyrings/qgis-archive-keyring.gpg https://download.qgis.org/downloads/qgis-archive-keyring.gpg

Add the QGIS repo for the latest stable QGIS (4.2.x Belém do Pará) to /etc/apt/sources.list.d/qgis.sources. Open the file in a text editor (e.g. sudo editor /etc/apt/sources.list.d/qgis.sources) and paste the following content (replace your-distributions-codename with your actual distribution codename, see Available codenames):

Types: deb deb-src
URIs: https://qgis.org/debian
Suites: your-distributions-codename
Architectures: amd64
Components: main
Signed-By: /etc/apt/keyrings/qgis-archive-keyring.gpg

Save and close the file, then update your repository information:

sudo apt update

To install QGIS, run:

sudo apt install qgis qgis-plugin-grass

Repositories ¶

Default Debian and Ubuntu software repositories often contain 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.d/qgis.sources 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 used to have extra packages in a separate repository that are based on ubuntugis, which held more up-to-date versions of other GIS packages than Ubuntu itself for LTS versions. If you want those you also need to include ubuntugis-unstable ppa in your /etc/apt/sources.list.d/qgis.list file (see ubuntugis documentation).

Lines of packages:

[2] Nightlies are debug builds (including debugging output)

(For more dates see Release Schedule on Road Map)

Supported distribution versions: ¶

[1] available dependencies in debian/ubuntu not QGIS 4 ready (Qt6 or dependant package, python or sip to old)

[2] builds based on ubuntugis dependencies

[3] starting with 3.40.8/3.44.0

[4] starting with 3.40.11/3.44.3

[5] starting with 4.0.1/3.44.9

To use the QGIS archive you have to first add the archive’s repository public key:

wget https://download.qgis.org/downloads/qgis-archive-keyring.gpg
gpg --no-default-keyring --keyring ./qgis-archive-keyring.gpg --list-keys

Should output:

./qgis-archive-keyring.gpg
--------------------------
pub   rsa4096 2022-08-08 [SCEA] [expires: 2027-08-08]
      2D7E3441A707FDB3E7059441D155B8E6A419C5BE
uid           [ unknown] QGIS Archive Automatic Signing Key (2022-2027) <qgis-developer@lists.osgeo.org>

After you have verified the output you can install the key with:

sudo mkdir -m755 -p /etc/apt/keyrings  # not needed since apt version 2.4.0 like Debian 12 and Ubuntu 22 or newer
sudo cp qgis-archive-keyring.gpg /etc/apt/keyrings/qgis-archive-keyring.gpg

Alternatively you can download the key directly without manual verification:

sudo mkdir -m755 -p /etc/apt/keyrings  # not needed since apt version 2.4.0 like Debian 12 and Ubuntu 22 or newer
sudo wget -O /etc/apt/keyrings/qgis-archive-keyring.gpg https://download.qgis.org/downloads/qgis-archive-keyring.gpg

With the keyring in place you can add the repository. Create or open for editing the file /etc/apt/sources.list.d/qgis.sources (e.g. sudo editor /etc/apt/sources.list.d/qgis.sources) and add the following content (replace *repository* and *codename* with values from the table above):

Types: deb deb-src
URIs: *repository*
Suites: *codename*
Architectures: amd64
Components: main
Signed-By: /etc/apt/keyrings/qgis-archive-keyring.gpg

Example for the latest long term release for Ubuntu 22.04 Jammy:

Types: deb deb-src
URIs: https://qgis.org/ubuntu-ltr
Suites: jammy
Architectures: amd64
Components: main
Signed-By: /etc/apt/keyrings/qgis-archive-keyring.gpg

After that type the commands below to install QGIS:

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

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

sudo apt update
sudo apt install qgis-server --no-install-recommends --no-install-suggests
# if you want to install server Python plugins
apt install python3-qgis

Flatpak ¶

There is a Flatpak for QGIS Stable and LTR available, maintained by the Flathub community.

For general install notes, see the Flathub website.

Here you can find QGIS on Flathub.

To install:

flatpak install flathub org.qgis.qgis

You will be prompted for the version of QGIS you want to use.

The app should appear in your app launcher, alternatively use this command:

flatpak run org.qgis.qgis

To update your Flatpak apps, including QGIS:

flatpak update

On certain distributions, you may also need to install the packages xdg-desktop-portal, together with xdg-desktop-portal-gtk, xdg-desktop-portal-kde or xdg-desktop-portal-cosmic in order for file dialogs to appear.

See the Flathub files here and report issues here.

Show runtime version ¶

If you need the following additions, you want to know which runtime QGIS is using:

flatpak info org.qgis.qgis --show-runtime

Extension support ¶

If you need to install additional Python modules, because they are needed by a plugin, you can install the module with (here installing the scipy module):

flatpak run --devel --command=pip3 org.qgis.qgis install scipy --user

# NOTE: you will likely get an error like: "error: runtime/org.kde.Sdk/x86_64/VERSION not installed" then also do:
flatpak install runtime/org.kde.Sdk/x86_64/VERSION

HTML rendering ¶

If you want to use HTML, for example in map layouts, QtWebkit is needed. You can install it from the flatpak command line interface

flatpak install app/io.qt.qtwebkit.BaseApp/x86_64/VERSION
# ⚠️ WARNING: This is considered insecure and is therefore not provided by default.

Fedora ¶

Get packages for Fedora variants using dnf by typing:

sudo dnf install qgis python3-qgis qgis-grass qgis-server

If you are on Fedora Atomic Desktops, you have 3 options:

1. Install the Flatpak

Flatpak is the recommended way to install packages on Fedora Atomic Desktops, skip to the instructions.

2. Install QGIS to the system

This is the easiest method, saves data and disk space, but will slow down system updates a bit

rpm-ostree install qgis python3-qgis qgis-grass qgis-server

3. Install in a toolbox or distrobox

Follow the toolbx and distrobox instructions.

Fedora switches between the current QGIS release and the LTR releases. The unstable “Rawhide” branch will ship newer but possibly buggy QGIS versions.

Always up-to-date version infos:

• QGIS
• QGIS-GRASS

NixOS ¶

Latest stable and LTR packages are available in nixpkgs. You can also run bleeding edge developer versions with a single command.

Basic Install ¶

Ephemeral use:

nix-shell -p qgis --command qgis

or

nix-shell -p qgis-ltr  --command qgis

Or added to your NixOS configuration.nix so that it becomes part of your system install:

For the LTR:

  environment.systemPackages = [
    pkgs.qgis-ltr
  ];

For latest stable:

environment.systemPackages = [
    pkgs.qgis
  ];

Running developer snapshots - Remote ¶

You can run in-development versions of QGIS with a single command directly from GitHub for any git revision (subsequent to 9 July 2025) from a branch or PR. Nix will automatically build and run the version you reference.

To run QGIS from the current commit of the master branch:

nix run github:qgis/QGIS#qgis

To run a specific revision:

nix run github:qgis/QGIS/<git revision>#qgis

To run a Pull Request or branch:

nix run github:qgis/QGIS/<git branch>#qgis

Running developer snapshots - Local ¶

If you have a local git checkout of QGIS, you can run your local source code tree:

nix run .#qgis

You can also create a developer environment by running the following command in the root of your QGIS git checkout directory:

nix develop

After running this command, you will see additional instructions for building displayed in the terminal.

Running with extra python packages: ¶

Due to isolation of Nix packages, you need to override the package if you want extra python packages to be available to QGIS. For example to run QGIS with numpy, geopandas and rasterio Python libraries you can do:

Ephemeral use:

nix-shell -p \
      'qgis.override { extraPythonPackages = (ps: [ ps.numpy ps.future ps.geopandas ps.rasterio ps.debugpy ]);}' \
      --command "qgis"

Or added to your NixOS configuration.nix so that it becomes part of your system install:

{
  config,
  pkgs,
  ...
}: {
  environment.systemPackages = with pkgs; [
    (qgis.override {
      extraPythonPackages = ps:
        with ps; [
          numpy
          geopandas
          rasterio
        ];
    })
    # other packages
  ];
}

SUSE / OpenSUSE ¶

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

All packages include GRASS and Python support.

All openSUSE Geo repositories can be found here: https://download.opensuse.org/repositories/Application:/Geo/

Install QGIS with this command:

sudo zypper in qgis qgis-plugin-grass 

On OpenSUSE microOS, Kalpa, Aeon and other immutable variants, refer to the distrobox instructions. Installing on the base system is possible but not recommended.

Mandriva ¶

QGIS stable ¶

Current:

urpmi qgis-python qgis-grass

Slackware ¶

QGIS stable ¶

Packages on https://slackbuilds.org/result/?search=qgis

Arch Linux ¶

QGIS stable ¶

QGIS stable is available in Arch Linux official repository : https://archlinux.org/packages/extra/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 supports 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 supports AUR:

yaourt -S qgis-git

For bugs and other behaviour, read comments here : https://aur.archlinux.org/packages/qgis-git

Spack ¶

Spack is a distro agnostic package manager for Linux, which is developed in the context of high-performance computing.

General info on installing Spack: https://github.com/spack/spack

QGIS package info on the Spack website: https://packages.spack.io/package.html?name=qgis

To install:

spack install qgis

which builds and installs QGIS and all dependencies from scratch. Afterwards, QGIS can be used via:

spack load qgis

If additional python packages need to be installed, using a Spack environment is recommended. For example:

spack env create myenv
spack env activate -p myenv
spack add qgis py-lz4
spack install

Spack related issues should be reported at: https://github.com/spack/spack/issues

Distrobox & Toolbx ¶

To install QGIS on any Linux system, you can also use distrobox or toolbx. These allow you to install common distributions like Fedora, OpenSUSE or Ubuntu inside a container. This can be a different version than your main operating system, and thus allows you to have a newer, testing, or more stable version of QGIS.

To setup a distrobox, here for example using OpenSUSE Tumbleweed:

distrobox-create box -i registry.opensuse.org/opensuse/toolbox:latest

distrobox-enter box
sudo zypper in qgis
distrobox-export --app qgis qgis-plugin-grass

Update QGIS in a distrobox:

distrobox upgrade --all

To create a toolbx:

toolbox create box -i registry.fedoraproject.org/fedora-toolbox:rawhide

toolbox enter box
sudo dnf install qgis qgis-grass python3-qgis

Update QGIS in a toolbx:

toolbx run -c box sudo dnf update

Mac OS X / macOS ¶

Binary packages (installers) ¶

Official All-in-one, signed and notarized installers for macOS can be downloaded from the QGIS download page. They are compatible with High Sierra (10.14) and newer for Intel x64 and Apple silicon (ARM) devices.

After downloading QGIS, open the DMG file. Drag and drop the QGIS application into the Applications folder.

MacPorts ¶

The package management system MacPorts offers both the latest release of QGIS 3.x (port qgis3) and the long term version (port qgis3-ltr). This will install QGIS with native architecture, Intel x64 or Apple silicon. Main software dependencies such as GDAL, PDAL and GRASS GIS are usually the latest version available.

Installing MacPorts and updating it and the ports are made with the Terminal. QGIS is however installed as an app bundle at /Applications/MacPorts/QGIS3.app.

Get information of a port:

sudo port info qgis3

Install port, e.g with GRASS GIS:

sudo port install qgis3 +grass

Update:

sudo port selfupdate
sudo port upgrade outdated

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/qgis/. 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

OpenBSD ¶

QGIS Stable

To install QGIS from third-party package

pkg_add qgis

See:

• https://openbsd.app/?search=qgis for -stable OpenBSD
• https://openbsd.app/?search=qgis¤t=on for -current OpenBSD

Container images ¶

Experimental (GPU accelerated) multi-arch JupyterLab QGIS container images.

• Current os/archs: linux/amd64, linux/arm64/v8
  • Run on Apple M series using Docker Desktop
  • or using Podman Desktop (rootless mode).
• Base images: Debian and Ubuntu
  • GPU accelerated images are CUDA-based (Ubuntu).
• TurboVNC: High-speed VNC version
  • CUDA-based images run VirtualGL to accelerate OpenGL applications.
• Just Python – no Conda / Mamba

For further information, see https://github.com/b-data/jupyterlab-qgis-docker-stack.

QGIS stable ¶

To run the container with the latest QGIS stable version, command

docker run -it --rm \
  -p 8888:8888 \
  -v jupyterlab-jovyan:/home/jovyan \
  quay.io/bedata/jupyterlab/qgis/base

To run the GPU accelerated container with the latest QGIS stable version, command

docker run -it --rm \
  --gpus 'device=all' \
  -p 8888:8888 \
  -v jupyterlab-jovyan:/home/jovyan \
  quay.io/bedata/jupyterlab/cuda/qgis/base

QGIS LTR ¶

To run the container with the latest QGIS LTR version, command

docker run -it --rm \
  -p 8888:8888 \
  -v jupyterlab-jovyan:/home/jovyan \
  quay.io/bedata/jupyterlab/qgis/base:ltr

To run the GPU accelerated container with the latest QGIS LTR version, command

docker run -it --rm \
  --gpus 'device=all' \
  -p 8888:8888 \
  -v jupyterlab-jovyan:/home/jovyan \
  quay.io/bedata/jupyterlab/cuda/qgis/base:ltr

QGIS version ¶

To run a container with a specific QGIS version, command

docker run -it --rm \
  -p 8888:8888 \
  -v jupyterlab-jovyan:/home/jovyan \
  quay.io/bedata/jupyterlab/qgis/base:MAJOR[.MINOR[.PATCH]]

To run a GPU accelerated container with a specific QGIS version, command

docker run -it --rm \
  --gpus 'device=all' \
  -p 8888:8888 \
  -v jupyterlab-jovyan:/home/jovyan \
  quay.io/bedata/jupyterlab/cuda/qgis/base:MAJOR[.MINOR[.PATCH]]

QGIS Testing warning ¶

Installing from Source ¶

Please refer to the developer installation notes for notes on how to build and install QGIS from source for the different platforms we support.