The vignette is a slightly adapted version of the installation guide of the archived RQGIS package. Big thanks to Patrick Schratz and Jannis Muenchow.
This vignette guides you through the installation process of QGIS, GRASS- and SAGA-GIS as well as Orfeo Toolbox and GDAL on three different platforms (Windows, Mac, Linux). Following the instructions should ensure that link2GI will work properly. With the exception of SAGA (SAGA is pretty idiosyncratic in questions of interface conformity), we recommend to use the latest stable version of all software packages.
Overall, link2GI allows access to more than some thousands of reliable and well known geo-algorithms. However, please note that the number of geo-algorithms you can use linking with link2GI depends on the platform, the system architecture, the selection of installed third-party providers and software package versions.
There are at least two options to install QGIS on Windows. The first option is the Standalone Installer from the QGIS installer page. This will install QGIS along with the third-party providers GRASS and SAGA. However, if you would like to use even more third-party providers (e.g., GDAL, GEOS, Taudem, OTB, PostGIS, etc.), it is strongly recommended to use the OSGeo4W Network installer. This installer is available on the QGIS installer page as well as on the OSGeo4W-website.
NOTE: Do not install QGIS 2.x
To install OSGeo4W, the easiest way is to to use the Express installation:
Sorry for the German dialogues. Nevertheless, it should be easy enough to follow our steps.
This installation is more or less equivalent to the standalone QGIS-installation. However, to have the full choice of available geoalgorithms provided by QGIS, we recommend to use the advanced settings of the OSGeo4W Network installer:
Additionally, we choose the Desktop-GIS GRASS 7, the Orfeo Toolbox, SAGA, and QGIS (even if not directly supported by link2GI right now). Here, we install both the most recent QGIS 3.x version as well as the long-term release.
Clicking “Next” once more will start the download and installation process which might take a while.
If you wish to to modify, uninstall or update some of the installed components, you might do so later on by running
Alternatively, you can download and run again the latest OSGeo4W-executable.
If you additionally want to use the LiDAR processing tools (LAStools), please follow the steps found here.
Please download the current (at this point OTB-7.2.0-Win64) or appropriate version of the Orfeo Toolbox software. Then follow the advice of the OTB team:
“We provide standalone binaries for Windows which do not require administrative privileges. Download the archive below (32 or 64 bits), and extract it somewhere. Double-click on the monteverdi.bat to launch Monteverdi, or mapla.bat for the OTB application browser. Please see the CookBook for detailed installation instructions.”
If you install QGIS with the built-in software managers, you will most likely get an outdated QGIS version. To install more recent QGIS releases, we recommend to follow the installation instructions from the QGIS installers website.
Here, we just describe exemplarily the QGIS installation procedure under Debian/Ubuntu following the description found here. link2GI should work as well with Linux derivatives other than Ubuntu. However, just Ubuntu , Debian and Manjaro are tested.
Open a terminal window. First of all, make sure to remove QGIS and GRASS packages you may have installed before from other repositories:
sudo apt-get --purge remove qgis sudo apt autoremove --purge-remove sudo apt autoremove sudo apt-get update
Next add the correct repository to
Here, we use the current long-term release (3.10):
QGIS 3.10.x for Ubuntu 20.04
# install necessary tools sudo apt install gnupg software-properties-common #add the required keys wget -qO - https://qgis.org/downloads/qgis-2020.gpg.key | sudo gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/qgis-archive.gpg --import # verify the key gpg --fingerprint 51F523511C7028C3 # add the repository # if there are problems sudo add-apt-repository "deb https://qgis.org/debian lsb_release -c -s main" # if there are problems use the hard-wired "focal" release sudo add-apt-repository "deb https://qgis.org/debian focal main"
After that, we can install QGIS and GRASS saga and Orfeo Toolbox as follows:
# install qgis grass otb saga sudo apt update sudo apt install qgis python-qgis qgis-plugin-grass grass saga otb-bin
If you would like to use another SAGA version, you need to compile it yourself (see here). Please note, however, that QGIS currently only supports the SAGA LTR 2.3.x as far as we know.
You can install various QGIS, SAGA and GRASS versions from the Arch User Repository.
You can install current stable QGIS, SAGA and GRASS GIS versions via the standard software package manager:
sudo dnf install qgis-python qgis qgis-grass saga grass-gui grass-libs
There is no binary install of SAGA for macOS.
We recommend to use the bottle installation from
# brew tap osgeo4mac brew install saga-gis-lts brew link saga-gis-lts --force
If you do not link SAGA with force, QGIS will not be able to detect SAGA.
Alternatively, you can compile SAGA from source from the SAGA website. However, this is tedious and QGIS2 only supports the SAGA LTS version.
You can install GRASS6 and GRASS7 via
# brew tap osgeo4mac brew install grass6 grass7
The binary GRASS installation can be found here.
However, we recommend to use the
When installing GRASS7 independently of QGIS via
homebrew, please make sure to install it before you have installed QGIS.
Only this way, the path for the QGIS processing plugin will be updated.
Otherwise, the GRASS installation will work, however,
GRASS7Utils.grassPath(), a QGIS function that links to the GRASS installation, gives back a non-existing path such as
/Applications/Grass-7.0.app/Contents/MacOS which in turn prevents GRASS algorithms from working from within QGIS.
Two options exist installing QGIS on macOS
# brew tap osgeo4mac brew install qgis3
brew info qgis3 for more available options.
However, if you use them, QGIS will be compiled from source which may take > 30 min (depending on your system).
Otherwise, pre-built bottles (= binaries) will be used which speeds up the installation process a lot.
Note: Make sure to install SAGA and GRASS before QGIS so that QGIS finds the correct paths.
Homebrew also supports GUI installations. QGIS can be installed using
brew cask install qgis
from the command line if homebrew is installed and configured correctly.
If you do not (want to) use
homebrew, you can install the QGIS binary from https://www.qgis.org/en/site/forusers/download.html.
This is exactly the same as calling
brew cask install qgis.
If you choose this option, you will get the following error messages during QGIS processing
QSqlDatabase: QSQLITE driver not loaded QSqlDatabase: available drivers: QSqlQuery::prepare: database not open  "ERROR: Opening of authentication db FAILED"  "WARNING: Auth db query exec() FAILED"