QGIS 설치관리자¶

어떻게 QGIS를 얻을 수 있는가?

QGIS는 엠에스윈도, 맥OS, 리눅스, 안드로이드 및 iOS에서 가능합니다.

정식으로 배포된 소프트웨어 패키지를 설치할 것을 권장합니다.

비개발자가 향후 배포될 버전을 평가하고, 개발자를 지원할 수 있도록 테스트 버전 패키지도 제공합니다. ( warning 을 확인하세요.)

이 패키지는 배포 전 기능 확정 기간 동안 (릴리스 스케줄 참조) 사용자가 테스트해볼 것을 강력히 권고하는 실질적인 사전 배포 패키지입니다.

엠에스 윈도¶

There are two options for installations on Windows:

Standalone installers¶

For beginners the easiest way is using the standalone installers:

배포판	버전	패키지
최근 배포판	3.30.3 ‘s-Hertogenbosch	Installer Checksum
Long Term Release	3.28.7 Firenze LTR	Installer Checksum
개발	3.31 마스터	Weekly snapshots

OSGeo4W installer¶

More advanced QGIS users should use OSGeo4W packages, which for one make it possible to install several versions in parallel and also to do much more efficient updates as only changed components are downloaded and installed.

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.

Steps are:

Download OSGeo4W Installer and start it
Choose Express Install and select QGIS to install the latest release and/or QGIS LTR to install the long term release.

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

배포판	버전	패키지	설명
최근 배포판	3.30.3 ‘s-Hertogenbosch	qgis	배포판
최근 배포판	3.30.3 ‘s-Hertogenbosch	qgis-rel-dev 1	다음 포인트 배포판의 나이틀리 빌드
Long Term Release	3.28.7 Firenze LTR	qgis-ltr	배포판
Long Term Release	3.28.7 Firenze LTR	qgis-ltr-dev 1	Nightly build of the upcoming long term point release
개발	3.31 마스터	qgis-dev 1	개발판 버전의 나이틀리 빌드

1(1,2,3): 나이틀리 빌드는 (디버그 작업 산출물을 포함하는) 디버그용 빌드입니다.

The packages listed in the table only install the necessary packages to run QGIS. Corresponding to those packages there are also meta packages with the postfix -full-free and -full. The former contains additional optional dependencies that some popular - not included - plugins use and the latter include the former and also add proprietary extensions like Oracle, ECW and MrSID.

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

Before installing any of the nightly builds note the warning.

리눅스¶

리눅스 배포판 대부분은 QGIS를 몇 개의 패키지로 분할해놓았습니다. 사용자들은 아마도 QGIS와 (플러그인 실행을 위한) qgis-python을 설치해야 할 것입니다. qgis-grass(또는 qgis-plugin-grass), qgis-server 같은 패키지는 초기에 건너뛸 수도 있고, 아니면 필요한 경우에만 설치할 수도 있습니다.

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

데비안/우분투¶

빠른 시작¶

참고

In the section following this one, you will find ALL possible options to install different versions of QGIS in different versions of Debian/Ubuntu. If you have problems, verify there whether your distribution is still supported as the repositories also contain older unsupported distributions with the last QGIS version that was supported. Beware that those might have meanwhile ceased to work.

여기에서는 사용자의 데비안 또는 우분투 시스템에 환경 설정 파일을 편집할 필요 없는 최신 QGIS 안정 버전(3.30.x ‘s-Hertogenbosch)만 설치할 것입니다.

참고

몇몇 부분에서 ‘Debian’을 볼 수도 있지만, ‘Ubuntu’로도 작동합니다. 우리 서버 상에서는 실질적으로 서로를 참조하는 심링크이기 때문입니다.

이 설치 지침에 필요한 몇 가지 도구를 먼저 설치하십시오:

sudo apt install gnupg software-properties-common

먼저 QGIS 저장소에서 다운되는 QGIS 소프트웨어를 신뢰하고 설치하게 해주는 QGIS 사인 키(Signing Key)를 설치하십시오:

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 (3.30.x ‘s-Hertogenbosch) to /etc/apt/sources.list.d/qgis.sources:

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

참고

Suites in above lines depends on your distribution. lsb_release -cs will show your distribution name.

In some distributions (like Linux Mint), . /etc/os-release; echo "$UBUNTU_CODENAME" will show the correct distibution name.

See Available codenames.

사용자의 저장소 정보가 방금 추가한 QGIS 저장소도 반영하도록 업데이트하십시오:

sudo apt update

이제 QGIS를 설치하십시오:

sudo apt install qgis qgis-plugin-grass

참고

Add qgis-server to this line if you also want to install QGIS Server

저장소¶

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

참고

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 2023-06-23 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 build-debian-packages).

Lines of packages:

배포판	버전	설명	저장소
최근 배포판	3.30.x ‘s-Hertogenbosch	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 5	https://qgis.org/debian-nightly-release https://qgis.org/ubuntu-nightly-release
		Nightly build of upcoming point release with ubuntugis-unstable dependencies 5	https://qgis.org/ubuntugis-nightly-release
장기 지원 배포판 저장소	3.28.x Firenze 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 5	https://qgis.org/debian-nightly-ltr https://qgis.org/ubuntu-nightly-ltr
		Nightly build of upcoming point release with ubuntugis-unstable dependencies 5	https://qgis.org/ubuntugis-nightly-ltr
Development Version	3.31 마스터	Nightly build for Debian and Ubuntu 5	https://qgis.org/debian-nightly https://qgis.org/ubuntu-nightly
Development Version	3.31 마스터	Nightly build with ubuntugis-unstable dependencies 5	https://qgis.org/ubuntugis-nightly

5(1,2,3,4,5,6): nightlies are debug builds (including debug output)

다음 포인트 릴리스
Next release: 2023-06-23 12:00:00 UTC
(more dates see Release Schedule on 로드맵)

Supported distribution versions:

Distribution	버전	Codename	Also available based on ubuntugis-unstable dependencies?
데비안	12.x (testing)	bookworm
	11.x (stable)	bullseye
	unstable	sid
우분투	23.04	lunar
	22.10	kinetic
	22.04 (LTS)	jammy	예
	20.04 (LTS)	focal 6	예

6: only up to QGIS 3.26 (Qt 5.13 required for 3.27)

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 as /etc/apt/sources.list.d/qgis.sources with following content:

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 python-qgis

참고

업데이트를 진행하기 전에 다른 저장소에서 설치된 모든 QGIS와 GRASS 패키지를 제거해 주십시오.

Fedora¶

다음을 타이핑해서 Fedora 용 패키지를 받으십시오:

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

Default Fedora software repositories often hold older versions of QGIS.

To have newer versions or the latest LTR, you have to add alternative software repositories based on the version you want to install (stable, LTR or testing).

QGIS 안정 버전¶

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	버전	QGIS 버전	GRASS GIS version
Fedora	36	3.28	8.0
Fedora	37	3.28	8.2

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

Distribution	버전	QGIS 버전	GRASS GIS version
Fedora	36	3.22	8.0
Fedora	37	3.22	8.2

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

SUSE / openSUSE¶

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

Distribution	저장소
Tumbleweed	https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Tumbleweed/
Leap 15.2	https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.2/
Leap 15.1	https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.1/
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/

모든 패키지에 GRASS 및 Python 지원이 포함되어 있습니다.

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

Mandriva¶

QGIS 안정 버전¶

현재:

urpmi qgis-python qgis-grass

Slackware¶

QGIS 안정 버전¶

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

Arch Linux¶

QGIS 안정 버전¶

Arch Linux 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 테스팅¶

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

Flatpak¶

There is an QGIS flatpak for QGIS Stable available, maintained by the flathub community.

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://dl.flathub.org/repo/appstream/org.qgis.qgis.flatpakref

Then to run:

flatpak run org.qgis.qgis

To update your flatpak QGIS:

flatpak update

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

Flathub files: https://github.com/flathub/org.qgis.qgis and report issues here: https://github.com/flathub/org.qgis.qgis/issues

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

Mac OS X / macOS¶

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

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/qgis/. The oldest installers support macOS 10.4 Tiger.

FreeBSD¶

QGIS 안정 버전¶

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&current=on # for -current OpenBSD

안드로이드¶

An old and deprecated not touch optimised release of QGIS for Android can be found on the google play store.

https://play.google.com/store/apps/details?id=org.qgis.qgis

경고

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¶

경고

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 INSTALL on how to build and install QGIS from source for the different platforms.