For Windows installers please go toThe main installers page.
For new users we recommend the standalone installers.
Download QGIS 2.14 for mac QGIS is a Free and Open Source Geographic Information System. With this software you can create, edit, visualise, analyse and publish geospatial information on Windows, Mac, Linux, BSD (Android coming soon) Mac OS X installers for QGIS. For OS X Mt Lion and newer. Install the Current version to stay up to date on.
For more advanced QGIS users you can use OSGeo4W packages, which make itpossible 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 neededpackages beforehand.The downloaded files are kept in a local directory for future installations.Steps are:
Download OSGeo4W Installer (32 bit or64 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.14.x Pi | qgis | Release |
qgis-rel-dev [1][4] | Nightly build of the upcoming point release | ||
Long Term ReleaseRepository | 3.10.x A CoruñaLTR | qgis-ltr | Release |
qgis-ltr-dev [2][4] | Nightly build of the upcoming point long term release | ||
Development | 3.15 master | qgis-dev [3][4] | 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 |
[4] | (1, 2, 3) Nightlies are debug builds (including debugging output) |
Note the warning.
Note
Don’t blindly do a full install of OSGeo4W. Only install QGIS andmaybe other components you like. Dependencies will be includedautomatically. A full install pulls in components that require third partyadditions, which need to be installed manually. These components render theinstallation unusable without those additions.
This chapter gives a quick overview of installing QGIS, some sample data fromthe QGIS web page, and running a first and simple session visualizing rasterand vector layers.
Installation of QGIS is very simple. Standard installer packages are availablefor MS Windows and Mac OS X. For many flavors of GNU/Linux, binary packages (rpmand deb) or software repositories are provided to add to your installation manager.Get the latest information on binary packages at the QGIS website athttp://download.qgis.org.
If you need to build QGIS from source, please refer to the installationinstructions. They are distributed with the QGIS source code in a filecalled INSTALL. You can also find them online athttp://htmlpreview.github.io/?https://raw.github.com/qgis/QGIS/master/doc/INSTALL.html
QGIS allows you to define a --configpath option that overrides the defaultpath for user configuration (e.g., ~/.qgis2 under Linux) and forcesQSettings to use this directory, too. This allows you to, for instance, carry aQGIS installation on a flash drive together with all plugins and settings.See section System Menu for additional information.
The user guide contains examples based on the QGIS sample dataset.
The Windows installer has an option to download the QGIS sample dataset.If checked, the data will be downloaded to your MyDocuments folder andplaced in a folder called GISDatabase. You may use Windows Explorer tomove this folder to any convenient location. If you did not select the checkboxto install the sample dataset during the initial QGIS installation,you may do one of the following:
For GNU/Linux and Mac OS X, there are not yet dataset installationpackages available as rpm, deb or dmg. To use the sample dataset, download thefile qgis_sample_data as a ZIP archive fromhttp://qgis.org/downloads/data/ and unzip the archiveon your system.
The Alaska dataset includes all GIS data that are used for examples andscreenshots in the user guide; it also includes a small GRASS database.The projection for the QGIS sample dataset is Alaska Albers Equal Area withunits feet. The EPSG code is 2964.
If you intend to use QGIS as a graphical front end for GRASS, you can find aselection of sample locations (e.g., Spearfish or South Dakota) at theofficial GRASS GIS website, http://grass.osgeo.org/download/sample-data/.
Starting QGIS is done as you usually do for any other application on yourplatform. It means that you can launch QGIS by:
To stop QGIS, click:
In previous section you learned how to start QGIS.You will see that QGIS also provides further command line options.
QGIS supports a number of options when started from the command line. Toget a list of the options, enter qgis--help on the command line. The usagestatement for QGIS is:
Tip
Example Using command line arguments
You can start QGIS by specifying one or more data files on the commandline. For example, assuming you are in the qgis_sample_datadirectory, you could start QGIS with a vector layer and a raster fileset to load on startup using the following command:qgis./raster/landcover.img./gml/lakes.gml
Command line option--snapshot
This option allows you to create a snapshot in PNG format from the current view.This comes in handy when you have a lot of projects and want to generatesnapshots from your data.
Currently, it generates a PNG file with 800x600 pixels. This can be adjustedusing the --width and --height command line arguments. A filename canbe added after --snapshot.
Command line option--lang
Based on your locale, QGIS selects the correct localization. If you would liketo change your language, you can specify a language code. For example,qgis--langit starts QGIS in Italian localization.
Command line option--project
Starting QGIS with an existing project file is also possible. Just add thecommand line option --project followed by your project name and QGIS willopen with all layers in the given file loaded.
Command line option--extent
To start with a specific map extent use this option. You need to add thebounding box of your extent in the following order separated by a comma:
Command line option--nologo
This command line argument hides the splash screen when you start QGIS.
command line option--noversioncheck
Don’t check for new version of QGIS at startup.
Command line option--noplugins
If you have trouble at start-up with plugins, you can avoid loading them atstart-up with this option. They will still be available from the Plugins Manager afterwards.
Command line option--customizationfile
Using this command line argument, you can define a GUI customization file, that willbe used at startup.
Command line option--nocustomization
Using this command line argument, existing GUI customization will not be appliedat startup.
Command line option--optionspath
You can have multiple configurations and decide which one to use when startingQGIS with this option. See Options to confirm where theoperating system saves the settings files. Presently, there is no way to specifya file to write settings to; therefore, you can create a copy ofthe original settings file and rename it. The option specifies path to directorywith settings. For example, to use /path/to/config/QGIS/QGIS2.ini settings file,use option:
Command line option--configpath
This option is similar to the one above, but furthermore overrides the defaultpath for user configuration (~/.qgis2) and forces QSettings to usethis directory, too. This allows users to, for instance, carry a QGIS installation on aflash drive together with all plugins and settings.
Command line option--authdbdirectory
Again, this option is similar to the one above but define the path to thedirectory where the authentication database will be stored.
Command line option--code
This option can be used to run a given python file directly after QGIS has started.
For example, when you have a python file named load_alaska.py with following content:
Assuming you are in the directory where the file load_alaska.py is located, youcan start QGIS, load the raster file landcover.img and give the layer the name‘Alaska’ using the following command:qgis--codeload_alaska.py
Command line options--dxf-*
These options can be used to export QGIS project into a DXF file. Severaloptions are available:
Now that you have QGIS installed and a sample dataset available, we wouldlike to demonstrate a short and simple QGIS sample session. We will visualizea raster and a vector layer. We will use:
You can see how easy it is to visualize raster and vector layers in QGIS. Let’smove on to the sections that follow to learn more about the availablefunctionality, features and settings, and how to use them.
The state of your QGIS session is considered a project. QGIS works on oneproject at a time. Settings are considered as being either per-project or as adefault for new projects (see section Options). QGIS can save thestate of your workspace into a project file using the menu optionsProject ‣Saveor Project ‣Save As....If the loaded project file on disk was meanwhile changed, by default, QGIS willask you if you want to overwrite the changes into the project file. This behavioris set by checking Prompt to save project and data sourcechanges when required under Settings ‣ Options ‣ Generalmenu .
Load saved projects into a QGIS session using Project ‣Open...,Project ‣ New from template orProject ‣ Open Recent ‣.
At startup, a list of screenshot with the name and path of each of the most recentprojects (up to ten) is shown instead of a white and empty map canvas. This isa handy and quicker way to remember what a project was about and double-clicka row opens the selected project.If you’re willing to create a new project, just add new layers and the list disappears.
If you wish to clear your session and start fresh, chooseProject ‣New.Either of these menu options will prompt you to save the existing project ifchanges have been made since it was opened or last saved.
The kinds of information saved in a project file include:
The project file is saved in XML format, so it is possible to edit the fileoutside QGIS if you know what you are doing. The file format has been updated severaltimes compared with earlier QGIS versions. Project files from older QGIS versionsmay not work properly any more. To be made aware of this, in theGeneral tab under Settings ‣ Options you shouldtick Warn when opening a project file saved with an olderversion of QGIS.
Whenever you save a project in QGIS a backup of the project file is made with theextension .qgs~.
There are several ways to generate output from your QGIS session. We havediscussed one already in section Projects, saving as a project file.Here is a sampling of other ways to produce output files: