Difference between revisions of "Installation Guide"

From GRASS-Wiki
Jump to: navigation, search
(Compile GRASS and package it (debian/testing))
m (macOS: fixing section heading)
 
(57 intermediate revisions by 13 users not shown)
Line 1: Line 1:
 
== General ==
 
== General ==
 +
:''For compilation of GRASS GIS source code, see [[Compile and Install]]''
 +
This page explains the installation of GRASS binaries.
  
''For compilation of GRASS source code, 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 [http://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 conforming to POSIX standards like Linux, Mac OS X, Solaris, IRIX, or BSD. It is also possible to run GRASS in MS Windows by using UNIX translation software such as Cygwin or MinGW. Ideally, you should have at least 500 Mb for data and 128 Mb RAM. The source code package needs around 30 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.
+
== 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 page [http://grass.osgeo.org/download/software/ms-windows/ GRASS GIS Download for MS-Windows]''
 +
 
 +
* Native winGRASS packages (including the installer) are provided [http://grass.osgeo.org/grass64/binary/mswindows/native/ here]. See also [[WinGRASS Current Status]].
 +
 
 +
* winGRASS/Cygwin packages are provided [http://grass.osgeo.org/grass64/binary/mswindows/cygwin/ here] (requires [[Cygwin]] UNIX emulator, see there).
 +
 
 +
* QGIS including native winGRASS packages are provided [http://www.qgis.org/wiki/Download here].
 +
 
 +
* Install using [http://trac.osgeo.org/osgeo4w/ OSGeo4W installer] (GRASS 6 needs to be checked in the "Express" install. GRASS 7 needs to be selected in the "Advanced" installation.)
  
 
== GNU/Linux ==
 
== GNU/Linux ==
 +
 +
:''The official page [http://grass.osgeo.org/download/software/linux/ GRASS GIS Download for GNU/Linux]''
  
 
=== Debian ===
 
=== Debian ===
Line 16: Line 29:
 
   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 [[http://grass.osgeo.org/grass64/binary/linux/snapshot/ 6.4 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 [http://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 ====
  
==== Compiling GRASS from source on Debian ====
+
* See [[Compile and Install]] of Source Code
Packages needed for (nearly) complete GRASS installation from source code:
 
  flex, bison, libreadline4-dev || libreadline5-dev, libncurses5-dev, lesstif2-dev, debhelper (>= 4.0.2), dpatch, libtiff4-dev,
 
  tcl8.4-dev, tk8.4-dev, fftw-dev, xlibmesa-gl-dev, libfreetype6-dev, autoconf2.13, autotools-dev, libgdal1-1.3.1-dev,
 
  proj (>= 4.4.7), libjpeg62-dev, libpng12-dev, postgresql-dev, unixodbc-dev, doxygen, fakeroot
 
  
==== Compile GRASS and package it (debian/testing) ====
+
=== Installation on Fedora ===
  
  grass6$ fakeroot debian/rules binary
+
[https://admin.fedoraproject.org/pkgdb/acls/name/grass Fedoraproject] provides RPM-packages for stable releases prepared to install on Fedora systems:
  
=== Fedora ===
+
<source lang="bash">
 +
yum install grass
 +
</source>
  
[http://ftp.gwdg.de/pub/misc/freegis/intevation/freegis/fedora/ Intevation] provides RPM-packages for stable releases prepared to install on Fedora systems.
+
=== Mandriva ===
 +
 
 +
* [http://sophie.zarb.org/srpm/cooker,ia64/grass Mandriva] provides PROJ/GDAL/GRASS RPMs. Newer versions they are in the "backports" section:
 +
 
 +
  urpmi grass
  
=== Mandriva ===
+
=== openSUSE ===
 +
 
 +
* [http://download.opensuse.org/repositories/Application:/Geo/ openSUSE] provides GRASS and related RPM-packages.
 +
 
 +
'''GRASS 6:''' To install GRASS 6 release on openSUSE:
 +
 
 +
From terminal:
 +
 
 +
<source lang="bash">
 +
sudo zypper ar http://download.opensuse.org/repositories/Application:/Geo/openSUSE_12.3/ GEO
 +
sudo zypper refresh
 +
sudo zypper install grass
 +
</source>
 +
 
 +
Alternatively, one can use the '''One-Click installer''':
 +
http://software.opensuse.org/package/grass
 +
 
 +
'''GRASS 7:''' To install the latest GRASS 7 SVN snapshot:
  
[http://www.gdf-hannover.de GDF Hannover] provides RPM-packages for stable releases prepared to install on Mandriva systems.
+
<source lang="bash">
 +
sudo zypper refresh
 +
sudo zypper install grass7
 +
</source>
  
You can download them here: [http://www.gdf-hannover.de/software]
+
Alternatively, one can use the '''One-Click installer''':
 +
http://software.opensuse.org/package/grass7
  
=== SuSE ===
+
=== Red Hat Enterprise Linux (RHEL, CentOS and Scientific Linux) ===
  
[http://www.gdf-hannover.de GDF Hannover] provides RPM-packages for stable releases prepared to install on SUSE-systems.
+
* [http://wiki.osgeo.org/wiki/Enterprise_Linux_GIS Enterprise Linux] offers GRASS and related binaries
  
You can download them here: [http://www.gdf-hannover.de/software]
+
<source lang="bash">
 +
yum install grass
 +
</source>
  
 
=== Ubuntu ===
 
=== Ubuntu ===
Line 60: Line 98:
 
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.
 
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.
  
== Mac OS X ==
+
=== Slackware ===
 +
 
 +
Slackware 12 packages for GRASS binary distributions and additional libraries are available from [http://repository.slacky.eu/slackware-12.2/scientific/grass The Italian Slackware Community] (release version) and [http://geni.ath.cx/grass.html#_Slackware_12_binary_distributions here] (SVN version).
 +
 
 +
=== Raspberry Pi ===
  
Precompiled Mac OSX packages can be found [http://wwwamb.bologna.enea.it/forgrass/download.htm here].
+
:''See the main page [[Raspberry Pi]].''
  
== MS-Windows ==
+
=== MacOS ===
  
* Precompiled winGRASS/Cygwin 6.1 packages are provided [http://geni.ath.cx/grass.html here] (requires Cygwin unix emulator, see there).
+
Precompiled GRASS 6 and GRASS 7 packages for macOS can be found [http://grass.osgeo.org/download/software/mac-osx/ 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.  
  
* Precompiled native winGRASS packages with QGIS integrated are provided [http://gisalaska.com/torrents/ here] (no Cygwin needed).
+
A brief introduction to how to install via [https://www.macports.org MacPorts]: [[Compiling on macOS using MacPorts]].
  
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Installation]]
 
[[Category:Installation]]

Latest revision as of 12:22, 1 July 2020

General

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 page GRASS GIS Download for MS-Windows
  • winGRASS/Cygwin packages are provided here (requires Cygwin UNIX emulator, see there).
  • QGIS including native winGRASS packages are provided here.
  • Install using OSGeo4W installer (GRASS 6 needs to be checked in the "Express" install. GRASS 7 needs to be selected in the "Advanced" installation.)

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 [6.4 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

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

 yum install grass

Mandriva

  • Mandriva provides PROJ/GDAL/GRASS RPMs. Newer versions they are in the "backports" section:
 urpmi grass

openSUSE

  • openSUSE provides GRASS and related RPM-packages.

GRASS 6: To install GRASS 6 release on openSUSE:

From terminal:

sudo zypper ar http://download.opensuse.org/repositories/Application:/Geo/openSUSE_12.3/ GEO
sudo zypper refresh
sudo zypper install grass

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

GRASS 7: To install the latest GRASS 7 SVN snapshot:

sudo zypper refresh
sudo zypper install grass7

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

Red Hat Enterprise Linux (RHEL, CentOS and Scientific Linux)

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

Slackware

Slackware 12 packages for GRASS binary distributions and additional libraries are available from The Italian Slackware Community (release version) and here (SVN version).

Raspberry Pi

See the main page Raspberry Pi.

MacOS

Precompiled GRASS 6 and GRASS 7 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.