Installation Guide: Difference between revisions

From GRASS-Wiki
Jump to navigation Jump to search
(crosslink)
 
(86 intermediate revisions by 18 users not shown)
Line 1: Line 1:
== General ==
== General ==
:''Note: For compilation of GRASS GIS source code, see [[Compile and Install]]''
This page explains the installation of GRASS binaries.


''For compilation of GRASS, see [[Compile and Install]].''
GRASS GIS requires a workstation running either some flavor of UNIX conforming to POSIX standards like Linux, Mac OS X, Solaris, IRIX, or BSD or MS-Windows. It is also possible to run GRASS in MS Windows by using UNIX translation software such as [[Cygwin]] or natively with MingGW. Ideally, you should have at least 500 Mb for data and 512 Mb RAM. The source code package needs around 270 MB uncompressed. The resulting binaries may need between 20 MB and 180 MB depending on your platform. During a full compilation you may need temporarily up to 150MB including the source code.


The [https://grass.osgeo.org/download/ Software Download Section] of the main GRASS web site contains the latest binaries and source code for all supported platforms. That site also has general directions for installing GRASS manually. However, installation is slightly different on each operating system. Here you can find user-contributed pointers for installing GRASS on specific platforms. In particular, many operating systems have package management utilities that can greatly simplify GRASS installation.


GRASS requires a workstation running some flavor of UNIX like Solaris, IRIX, Linux, BSD, Mac OS X or cygwin (on Windows). Ideally, you should have at least 500 Mb for data and 32 Mb RAM. The source code package needs around 50 MB uncompressed. The resulting binaries may need between 20 MB and 180 MB depending on your platform. During a full compilation you may need temporarily up to 550MB including the source code.
== MS Windows ==


The [http://grass.itc.it/download/index.php Software Download Section] of the main GRASS web site contains the latest binaries and source code for all supported platforms. That site also has general directions for installing GRASS manually. However, installation is slightly different on each operating system. Here you can find user-contributed pointers for installing GRASS on specific platforms. In particular, many operating systems have package management utilities that can greatly simplify GRASS installation.
:''The official download page [https://grass.osgeo.org/download/windows/ GRASS GIS for MS-Windows]''
 
There are two main flavours:
* '''OSGeo4W installer''', for a broad set of open source geospatial software packages including GRASS GIS as well as many other packages (QGIS, GDAL/OGR, and more). Advantage: whenever you run again the OSGeo4W installer, it updates the existing installation.
* '''Standalone winGRASS installer''': install GRASS GIS with the required support packages.
 
=== OSGeo4W installer ===
 
OSGeo4W is an installer for a broad set of open source geospatial software packages including GRASS GIS as well as many other packages (QGIS, GDAL/OGR, and more). Advantage: whenever you run again the OSGeo4W installer, it updates the existing installation.
 
* Install using [https://trac.osgeo.org/osgeo4w/ OSGeo4W installer] which installs all dependencies as well (PROJ, GDAL, GEOS, Python, etc.)
 
==== Launch the OSGeo4W installer ====
 
Save the downloaded installer (consider to keep it for future updates) and run it as an ''administrator''.
You can select either the grass (stable) or grass-daily (development) packages to install.,
 
[[Image:Osgeo4w_1.png|center|thumb|500px|Install with "Administrator" rights]]
 
==== Variant A) Express installation ====
 
Use "Express Desktop Install" mode to select stable version.
 
[[Image:Osgeo4w_2_express.png|center|thumb|500px|Use "Express installation" to select stable version]]
 
[[Image:Osgeo4w_3_express.png|center|thumb|500px]]
 
Common installed Python packages:
 
* python3-gdal
* python3-matplotlib
* python3-wx
* python3-numpy
* python3-pillow
* python3-pip
* python3-ply
* python3-pyopengl 
* python3-psycopg2
* python3-six
* python3-pywin32
 
Additional useful packages (e.g. python3-pandas, msys) can be installed in "Advanced Install" mode.
 
==== Variant B) Advanced installation ====
 
Use "Advanced Install Mode" to select development version.
 
[[Image:Osgeo4w_2_advanced.png|center|thumb|500px|Use "Advanced installation" to select development version]]
 
[[Image:Osgeo4w_3_advanced.png|center|thumb|500px]]
 
=== winGRASS standalone installer ===
 
* Native winGRASS package installer is available [https://grass.osgeo.org/grass-stable/binary/mswindows/native/ here].
 
=== QGIS with winGRASS installer ===
* QGIS including native winGRASS packages are provided [https://www.qgis.org/wiki/Download here].


== GNU/Linux ==
== GNU/Linux ==
:''The official page [https://grass.osgeo.org/download/linux/ GRASS GIS Download for GNU/Linux]''


=== Debian ===
=== Debian ===
Line 14: Line 75:
A binary version of GRASS is available from the apt repository. As root type:
A binary version of GRASS is available from the apt repository. As root type:


apt-get install grass grass-doc
  apt-get install grass grass-doc


This is the easiest way to install GRASS on Debian. If you choose to install a binary version manually from the main web site, be sure to follow the instructions for making symlinks found as a note to the [[http://grass.itc.it/grass61/binary/linux/snapshot/ 6.1 weekly snapshot]] release.
This is the easiest way to install GRASS on Debian. If you choose to install a binary version manually from the main web site, be sure to follow the instructions for making symlinks found as a note to the [[https://grass.osgeo.org/grass-stable/binary/linux/snapshot/ GRASS GIS stable weekly snapshot]] release.


==== DebianGis ====
==== DebianGIS ====


There is also the wonderfull [http://pkg-grass.alioth.debian.org/cgi-bin/wiki.pl DebianGIS] project which has a more recent GRASS version with its related packages.
There is also the wonderful [https://wiki.debian.org/DebianGis DebianGIS] project which has a more recent GRASS version with its related packages. Read here for more [[GRASS in Debian |details]]


To install from there follow the [http://pkg-grass.alioth.debian.org/cgi-bin/wiki.pl/DebianGisRepository instructions] there
==== Compiling GRASS from source ====


=== Fedora ===
* See [[Compile and Install]] of Source Code


[http://ftp.gwdg.de/pub/misc/freegis/intevation/freegis/fedora/ Intevation] provides RPM-packages for stable releases prepared to install on Fedora systems.
=== Installation on Fedora ===


=== Mandriva ===
The [https://src.fedoraproject.org/rpms/grass Fedora project] provides RPM-packages for stable releases prepared to install on Fedora systems:


[http://www.gdf-hannover.de GDF Hannover] provides RPM-packages for stable releases prepared to install on Mandriva systems.
<source lang="bash">
sudo dnf install grass grass-gui
</source>


You can download them here: [http://www.gdf-hannover.de/software]
=== Mageia ===


=== SuSE ===
* [https://madb.mageia.org/package/show/name/grass/ Mageia] provides PROJ/GDAL/GRASS RPMs:


[http://www.gdf-hannover.de GDF Hannover] provides RPM-packages for stable releases prepared to install on SUSE-systems.
  urpmi grass


You can download them here: [http://www.gdf-hannover.de/software]
=== openSUSE ===
 
* [https://build.opensuse.org/package/show/Application:Geo/grass openSUSE] provides GRASS and related RPM-packages:
 
<source lang="bash">
sudo zypper refresh
sudo zypper install grass
</source>
 
Alternatively, one can use the '''One-Click installer''':
https://software.opensuse.org/package/grass
 
=== Red Hat Enterprise Linux (RHEL, CentOS and EPEL) ===
 
* [https://src.fedoraproject.org/rpms/grass Fedora] offers GRASS and related binaries for CentOS and EPEL
 
<source lang="bash">
dnf install grass
</source>


=== Ubuntu ===
=== Ubuntu ===
Line 44: Line 125:
GRASS Binaries are available from apt/synaptic. From a terminal type:
GRASS Binaries are available from apt/synaptic. From a terminal type:


sudo apt-get install grass grass-doc
  sudo apt-get install grass grass-doc


or alternatively, search for and install these packages from Synaptic. This is the easy way to get GRASS on your system. Even if you choose to install binaries from another source, you may want to install this version just so that all (most) dependencies are installed as painlessly as possible.
or alternatively, search for and install these packages from Synaptic. This is the easy way to get GRASS on your system. Even if you choose to install binaries from another source, you may want to install this version just so that all (most) dependencies are installed as painlessly as possible.


As of 2006-05-21, the latest binary available is GRASS 6.0.1 which is a step version behind the current stable release (GRASS 6.0.2). If you wish to install a more recent binary version, you will need to download the binary package from the GRASS web site and follow the instructions for installing on [[#Debian]]. You may find that the effort required to install the binary manually is not much less than compiling the whole package from source. If this is the case, I recommend compiling the development version of GRASS (6.1-cvs) to take advantage of the exiting new capabilities built into 6.1.
To get the latest version of GRASS on Ubuntu, compile the code from source. See the [[Compile and Install]] section for a shell script that makes this easy.
 
== MacOS ==
 
Precompiled GRASS GIS packages for macOS can be found [https://grass.osgeo.org/download/mac here]. These are distributed as zipped *.dmg packages. Opening the dmg prompts the user to simply drag and drop the app into the Applications folder. In fact, they '''must''' be installed into the Applications folder and may not run properly in other locations.  


== Mac OS X ==
A brief introduction to how to install via [https://www.macports.org MacPorts]: [[Compiling on macOS using MacPorts]].


Precompiled Mac OSX packages can be found [http://wwwamb.bologna.enea.it/forgrass/download.htm here].
== Raspberry Pi ==


== MS-Windows ==
:''See the main page [[Raspberry Pi]].''


* Precompiled winGRASS/Cygwin 6.1 packages are provided [http://geni.ath.cx/grass.html here] (requires Cygwin unix emulator, see there).
[[Category:Documentation]]
* Precompiled native winGRASS packages with QGIS integrated are provided [http://mpa.itc.it/radim/wingrass/ here] (no Cygwin needed).
[[Category:Installation]]

Latest revision as of 20:03, 30 July 2024

General

Note: For compilation of GRASS GIS source code, see Compile and Install

This page explains the installation of GRASS binaries.

GRASS GIS requires a workstation running either some flavor of UNIX conforming to POSIX standards like Linux, Mac OS X, Solaris, IRIX, or BSD or MS-Windows. It is also possible to run GRASS in MS Windows by using UNIX translation software such as Cygwin or natively with MingGW. Ideally, you should have at least 500 Mb for data and 512 Mb RAM. The source code package needs around 270 MB uncompressed. The resulting binaries may need between 20 MB and 180 MB depending on your platform. During a full compilation you may need temporarily up to 150MB including the source code.

The Software Download Section of the main GRASS web site contains the latest binaries and source code for all supported platforms. That site also has general directions for installing GRASS manually. However, installation is slightly different on each operating system. Here you can find user-contributed pointers for installing GRASS on specific platforms. In particular, many operating systems have package management utilities that can greatly simplify GRASS installation.

MS Windows

The official download page GRASS GIS for MS-Windows

There are two main flavours:

  • OSGeo4W installer, for a broad set of open source geospatial software packages including GRASS GIS as well as many other packages (QGIS, GDAL/OGR, and more). Advantage: whenever you run again the OSGeo4W installer, it updates the existing installation.
  • Standalone winGRASS installer: install GRASS GIS with the required support packages.

OSGeo4W installer

OSGeo4W is an installer for a broad set of open source geospatial software packages including GRASS GIS as well as many other packages (QGIS, GDAL/OGR, and more). Advantage: whenever you run again the OSGeo4W installer, it updates the existing installation.

  • Install using OSGeo4W installer which installs all dependencies as well (PROJ, GDAL, GEOS, Python, etc.)

Launch the OSGeo4W installer

Save the downloaded installer (consider to keep it for future updates) and run it as an administrator. You can select either the grass (stable) or grass-daily (development) packages to install.,

Install with "Administrator" rights

Variant A) Express installation

Use "Express Desktop Install" mode to select stable version.

Use "Express installation" to select stable version

Common installed Python packages:

  • python3-gdal
  • python3-matplotlib
  • python3-wx
  • python3-numpy
  • python3-pillow
  • python3-pip
  • python3-ply
  • python3-pyopengl
  • python3-psycopg2
  • python3-six
  • python3-pywin32

Additional useful packages (e.g. python3-pandas, msys) can be installed in "Advanced Install" mode.

Variant B) Advanced installation

Use "Advanced Install Mode" to select development version.

Use "Advanced installation" to select development version

winGRASS standalone installer

  • Native winGRASS package installer is available here.

QGIS with winGRASS installer

  • QGIS including native winGRASS packages are provided here.

GNU/Linux

The official page GRASS GIS Download for GNU/Linux

Debian

A binary version of GRASS is available from the apt repository. As root type:

 apt-get install grass grass-doc

This is the easiest way to install GRASS on Debian. If you choose to install a binary version manually from the main web site, be sure to follow the instructions for making symlinks found as a note to the [GRASS GIS stable weekly snapshot] release.

DebianGIS

There is also the wonderful DebianGIS project which has a more recent GRASS version with its related packages. Read here for more details

Compiling GRASS from source

Installation on Fedora

The Fedora project provides RPM-packages for stable releases prepared to install on Fedora systems:

 sudo dnf install grass grass-gui

Mageia

  • Mageia provides PROJ/GDAL/GRASS RPMs:
 urpmi grass

openSUSE

  • openSUSE provides GRASS and related RPM-packages:
sudo zypper refresh
sudo zypper install grass

Alternatively, one can use the One-Click installer: https://software.opensuse.org/package/grass

Red Hat Enterprise Linux (RHEL, CentOS and EPEL)

  • Fedora offers GRASS and related binaries for CentOS and EPEL
 dnf install grass

Ubuntu

GRASS Binaries are available from apt/synaptic. From a terminal type:

 sudo apt-get install grass grass-doc

or alternatively, search for and install these packages from Synaptic. This is the easy way to get GRASS on your system. Even if you choose to install binaries from another source, you may want to install this version just so that all (most) dependencies are installed as painlessly as possible.

To get the latest version of GRASS on Ubuntu, compile the code from source. See the Compile and Install section for a shell script that makes this easy.

MacOS

Precompiled GRASS GIS packages for macOS can be found here. These are distributed as zipped *.dmg packages. Opening the dmg prompts the user to simply drag and drop the app into the Applications folder. In fact, they must be installed into the Applications folder and may not run properly in other locations.

A brief introduction to how to install via MacPorts: Compiling on macOS using MacPorts.

Raspberry Pi

See the main page Raspberry Pi.