QGIS のインストーラー ¶

QGIS は Windows, macOS, Linux, FreeBSD, OpenBSD, Android とiOSで利用可能です。

LTR（長期リリース）バージョンは、リリースの前により厳格なテストが行われ、少なくとも1年間のバグ修正アップデートが提供されるため、LTRパッケージをインストールすることをお勧めします。

the main installers page も参照してください。

次期リリースの評価や、開発者以外の方にも開発をサポートしていただけるよう、テスト用パッケージも提供しています (注 警告 をご確認して下さい).

リリース前のフィーチャーフリーズ期間中 ( リリーススケジュール 参照) 、これらのパッケージは事実上 プレリリース版となります。ユーザーの皆様にはテストへのご協力を強くお願いします 。

Windows ¶

Windowsへのインストール方法は2つあります:

オフライン (単独) インストーラー ¶

スタンドアロンインストーラーには、QGISに必要なすべてが1つのダウンロードファイルに含まれています。一度インストーラーを入手すれば、インストールを完了するのにインターネット接続は必要ありません。新しいリリースが利用可能になった際にアップグレードするには、完全なインストーラーを再度ダウンロードする必要があります。初心者にとって、スタンドアロンインストーラーはおそらく最も簡単なQGISのインストール方法です:

オプションの投影グリッドはファイルサイズが大きいため、デフォルトのインストーラーには含まれていません。QGISは実行時に再投影にグリッドが必要かどうかを判断し、手動ダウンロードを求めます。

それが難しい環境や不便な場合のために、グリッドを含むスタンドアロンインストーラーも引き続き提供しています。4.0.1時点では、通常のインストーラーは0.5 GiB、全グリッドを含むインストーラーは1.2 GiBです。

付属の “OSGeo4W Setup” を使って proj-data パッケージをインストールすることで、後からグリッドを追加することもできます。または、同じく付属のコマンドラインツール projsync を使って、特定のエリアのグリッドをダウンロードすることもできます。

OSGeo4Wのナイトリー qgis-dev パッケージのウィークリースナップショットは、何らかの理由でOSGeo4W（下記参照）を使用できないユーザーや、単にスタンドアロンインストーラーを好むユーザー向けに提供されています。機能フリーズ（開発凍結）フェーズでは、これらは リリース候補（RC） インストーラーとしての役割も果たします。

オンライン (OSGeo4W) インストーラー ¶

上級者向けには、OSGeo4Wパッケージの使用をお勧めします。このインストーラーを使うと、複数バージョンのQGISを並行してインストールできるほか、新しいリリースのたびに変更されたコンポーネントのみがダウンロード・インストールされるため、より効率的なアップデートが可能です。

OSGeo4W リポジトリには、多くの OSGeo プロジェクトのソフトウェアが含まれています。Python、GRASS、GDAL などとともに、QGIS とすべての依存関係が含まれています。インストーラーは、インターネットからインストールすることも、必要なパッケージを事前にダウンロードすることも可能です。ダウンロードしたファイルは、将来のインストールのためにローカルディレクトリに保存され、オフラインでインストールするために使用することもできます。

インストール手順:

• OSGeo4W Installer をダウンロードして実行して下さい。
• 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] ナイトリービルドはデバッグビルドです (開発者がビルドの問題をより深く理解するために活用できるデバッグ出力を含みます)。

[2] 4.0はQt6への移行を示すバージョンです。それ以前のQGISバージョンではQt6は実験的なサポートでした。4.0以降はQt6のみがサポートされます。

上記の表に記載されているパッケージは、QGISの実行に必要な依存関係のみをインストールします。これらのパッケージに対応して、 -full-free および -full というサフィックスを持つメタパッケージも提供しています。 -full-free には、一部の人気プラグイン（デフォルトのQGISインストールには含まれない）が使用する追加のオプション依存関係が含まれます。 -full は -full-free のすべてに加え、Oracleドライバー、ECW、MrSIDなどのプロプライエタリな拡張機能も含みます。

エクスプレスインストールは対応する -full バリアントを参照しており、スタンドアロンインストーラーもこれらのOSGeo4Wパッケージセットから作成されています。

-full-grids バリアントはオプションの投影グリッドを含みます（つまり、-full に proj-data パッケージを加えたものです）。大容量のスタンドアロンインストーラーはこれらをベースにしています。

ナイトリービルドをインストールする前に、以下の 警告 をご確認ください。

Linux ¶

ほとんどのLinuxディストリビューションではQGISは複数のパッケージに分割されています。通常は qgis と qgis-python （プラグインの実行に必要）が必要です。 qgis-grass （または qgis-plugin-grass ）や qgis-server などのパッケージは、必要に応じてインストールできます。

以下に、ディストリビューションごとの具体的なインストール手順を記載しています。ほとんどのディストリビューションについて、安定版QGISおよび最新のQGISテストビルドのインストール手順を提供しています ( warning 参照) 。

Debian / Ubuntu ¶

クイックスタート ¶

設定ファイルを編集することなく、DebianまたはUbuntuに最新の安定版QGIS (4.0.x Norrköping) を簡単にインストールできます。

まず、この手順に必要なツールをインストールします:

sudo apt install gnupg software-properties-common

次に、QGISリポジトリからのソフトウェアが信頼され、インストールできるようにQGIS署名キーをインストールします:

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

最新の安定版QGIS (4.0.x Norrköping) のQGISリポジトリを /etc/apt/sources.list.d/qgis.sources に追加します。 テキストエディターでファイルを開き (例 sudo editor /etc/apt/sources.list.d/qgis.sources) 、以下の内容を貼り付けてください ( your-distributions-codename は実際のディストリビューションのコードネームに置き換えてください, 利用可能なコードネーム 参照):

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

ファイルを保存して閉じるとあなたのリポジトリ情報が更新されます:

sudo apt update

QGISをインストールするには、次のコマンドを実行します:

sudo apt install qgis qgis-plugin-grass

リポジトリ ¶

DebianおよびUbuntuのデフォルトのソフトウェアリポジトリには、古いバージョンのQGISが含まれていることがよくあります。

より新しいバージョンを入手するには、以下のdebラインのいずれかを /etc/apt/sources.list.d/qgis.sources ファイルに追加して、代替ソフトウェアリポジトリを設定する必要があります。

私たちのメインリポジトリには、個々のディストリビューションが提供する依存関係に基づいて、 DebianとUbuntu のいくつかのバージョンのパッケージが複数含まれています。

Ubuntuについては、以前は ubuntugis をベースにした別リポジトリで追加パッケージを提供していました。このリポジトリには、LTSバージョンのUbuntu自体よりも新しい他のGISパッケージが含まれていました。これらが必要な場合は、/etc/apt/sources.list.d/qgis.list ファイルに ubuntugis-unstable ppa も追加する必要があります (ubuntugisのドキュメント 参照)。

パッケージのラインアップ：

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

(For more dates see Release Schedule on Road Map)

サポートされているディストリビューションのバージョン： ¶

[1] debian/ubuntuの利用可能な依存関係がQGIS 4に対応していない (Qt6または依存パッケージ、pythonまたはsipが古すぎる)

[2] ubuntugis依存関係に基づくビルド

[3] 3.40.8/3.44.0から開始

[4] 3.40.11/3.44.3 から開始

[5] 4.0.1/3.44.9 から開始

QGISアーカイブを使用するには、まずアーカイブのリポジトリ公開鍵を追加する必要があります:

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

出力結果:

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

出力を確認したら、以下のコマンドでキーをインストールできます:

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

または、手動での確認なしに直接キーをダウンロードすることもできます:

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

キーリングが設定されたら、リポジトリを追加できます。/etc/apt/sources.list.d/qgis.sources ファイルを作成または編集用に開き（例：sudo editor /etc/apt/sources.list.d/qgis.sources ）、以下の内容を追加してください（repository と codename は上記の表の値に置き換えてください）:

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

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

その後、以下のコマンドを入力してQGISをインストールします:

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

QGIS Serverをインストールする場合は、次のコマンドを入力します:

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 ¶

Flathubコミュニティによってメンテナンスされている、QGIS安定版とLTR向けのFlatpakが利用可能です。

一般的なインストール手順については、　Flathubのウェブサイト を参照してください。

こちらでFlathub上のQGISを見つけることができます.

インストールするには:

flatpak install flathub org.qgis.qgis

使用するQGISのバージョンを選択するよう求められます。

アプリがアプリランチャーに表示されるはずです。または、以下のコマンドを使用してください:

flatpak run org.qgis.qgis

QGISを含むFlatpakアプリを更新するには:

flatpak update

特定のディストリビューションでは、ファイルダイアログが表示されるようにするために xdg-desktop-portal パッケージと xdg-desktop-portal-gtk 、xdg-desktop-portal-kde 、または xdg-desktop-portal-cosmic のインストールが必要な場合があります。  

Flathubのファイルはこちらで 確認でき 問題の報告はこちらから 行えます。

ランタイムバージョンの表示 ¶

以下の追加機能が必要な場合、QGISが使用しているランタイムを確認する必要があります:

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

拡張機能のサポート ¶

プラグインに必要な追加のPythonモジュールをインストールする場合、以下のコマンドでモジュールをインストールできます（ここでは scipy モジュールをインストールする例）:

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 レンダリング ¶

マップレイアウトなどでHTMLを使用したい場合は、QtWebkit が必要です。FlatpakのコマンドラインインターフェースからインストールできますL

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

Fedora ¶

Fedora系ディストリビューション向けのパッケージを dnf を使用して以下のコマンドで取得します:

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

Fedora Atomic Desktops を使用している場合、3つのオプションがあります:

1. Flatpak のインストール

FlatpakはFedora Atomic Desktopsにパッケージをインストールするための推奨方法です, skip to the instructions. 2. システムへのQGISのインストール

これは最も簡単な方法で、データとディスクスペースを節約できますが、システムの更新が少し遅くなります。

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

3. toolboxまたはdistroboxへのインストール

toolbx と distrobox の instructions に従ってください。

FedoraはQGISの現在のリリースとLTRリリースを切り替えます。不安定な “Rawhide” ブランチでは、より新しいがバグを含む可能性があるQGISバージョンが提供されます。

常に更新されるバージョン情報はこちらです:

• 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

または

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:

すべてのパッケージには GRASS と Pythonのサポートが含まれています。

全てのopenSUSE Geo リポジトリは、 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安定版 ¶

Current:

urpmi qgis-python qgis-grass

Slackware ¶

QGIS安定版 ¶

https://slackbuilds.org/result/?search=qgis 上のパッケージ

Arch Linux ¶

QGIS安定版 ¶

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長期リリースはAUR（Arch User Repository）にあります。

Install with yaourt or other package manager which supports AUR:

yaourt -S qgis-ltr

バグやその他の振る舞いについては、ここのコメントを読んでください： https://aur.archlinux.org/packages/qgis-ltr/

QGIS テスト版 ¶

QGIS テスト版は AUR (Arch User Repository) にあります。

Install with yaourt or other package manager which supports AUR:

yaourt -S qgis-git

バグやその他の振る舞いについては、ここのコメントを読んでください： https://aur.archlinux.org/packages/qgis-git

Spack ¶

SpackはLinux用のdistro-agnosticパッケージマネージャで、ハイパフォーマンスコンピューティングの文脈で開発されています。

Spackのインストール方法に関する一般的な情報: https://github.com/spack/spack

Spack の QGIS パッケージファイル: https://github.com/spack/spack/blob/develop/var/spack/repos/builtin/packages/qgis/package.py

インストールするには:

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に関係した問題は次に報告してください: 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 ¶

バイナリパッケージ (installers) ¶

macOS用の公式オールインワン、署名・公証済みインストーラーは QGIS download page からダウンロードできます。これらは、Intel x64およびAppleシリコン（ARM）デバイスのHigh Sierra（10.14）以降に対応しています。

QGISをダウンロードしたら、DMGファイルを開きます。QGISアプリケーションをアプリケーションフォルダにドラッグ＆ドロップします。

MacPorts ¶

パッケージ管理システム MacPorts では、最新リリース版 (port qgis3) と長期サポート版 (port qgis3-ltr) の両方を提供しています。これにより、Intel x64またはApple Silicon のネイティブアーキテクチャでQGISがインストールされます。GDAL、PDAL、GRASS GISなどの主要な依存ソフトウェアは通常、利用可能な最新バージョンが使用されます。

MacPorts のインストールと更新 、および ports の操作は ターミナル から行います。QGISはアプリバンドルとして /Applications/MacPorts/QGIS3.app にインストールされます。

ポートの情報取得:

sudo port info qgis3

ポートのインストール, e.g with GRASS GIS:

sudo port install qgis3 +grass

更新:

sudo port selfupdate
sudo port upgrade outdated

古いリリース ¶

以前のリリースの公式インストーラーは、 https://qgis.org/downloads/macos/ からダウンロードできます。

以前のリリースの kyngchaos インストーラーは https://www.kyngchaos.com/software/archive/qgis/ からダウンロードできます。最も古いインストーラーはmacOS 10.4 Tigerをサポートしています。

FreeBSD ¶

QGIS安定版 ¶

バイナリパッケージタイプからQGISをインストールする

pkg install qgis

または、コンパイルオプションをカスタマイズしたい場合は、FreeBSD portsからビルドすることもできます。

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

QGIS LTR ¶

バイナリパッケージタイプからQGISをインストールする

pkg install qgis-ltr

または、コンパイルオプションをカスタマイズしたい場合は、FreeBSD portsからビルドすることもできます。

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

OpenBSD ¶

QGIS Stable

サードパーティパッケージからQGISをインストールする

pkg_add qgis

参照:

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

コンテナイメージ ¶

実験的な（GPUアクセラレーション対応）マルチアーキテクチャ JupyterLab QGISコンテナイメージ。

• 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安定版 ¶

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バージョン ¶

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 テスト版に関する警告 ¶

ソースからインストールする ¶

サポートしている各プラットフォームでのQGISのソースからのビルドおよびインストール方法については、 開発者向けインストールノート を参照してください。