Download

Download GRASS for macOS

Find GRASS binary installers for current, legacy, and preview releases on GRASS for the Mac.

Installation

MacPorts

Install with the following shell command:

sudo port install grass

For more information visit MacPorts GRASS.

See this brief introduction on using MacPorts. GRASS is also available for macOS (Intel and Apple Silicon) from conda-forge — see the Conda tab.

Contribute

Please consider a financial contribution to the GRASS project to help us improve and maintain the software.

Download GRASS for Windows

Install GRASS on Windows with the OSGeo4W installer. GRASS is also available for Windows (64-bit) from conda-forge — see the Conda tab.

Installation

OSGeo4W

OSGeo4W is an installer for a broad set of open source geospatial software packages including GRASS as well as many other packages (QGIS, GDAL/OGR, and more). Download the OSGeo4W v2 installer to install GRASS and other OSGeo software on Windows.

OSGeo4W v2 is the standard repository and does not include a 32-bit version. The legacy v1 installers are only needed for 32-bit systems. Upgrading an existing v1 installation by pointing it at the v2 repository is not supported — do a fresh install or use a different install directory.

The following install modes are offered (see also the dedicated wiki page for further details):

Express desktop install mode

Run the downloaded installer as administrator and select the grass (stable) or grass-daily (development) packages to install. All needed dependencies (e.g. GDAL, common python packages) will be automatically downloaded.

Advanced install mode

All packages can be individually selected and additional useful packages (e.g. python-pandas, msys) are available, too.

Command line installation

Installation can also be done through the command line:

osgeo4w-setup.exe -q -k -P grass -s https://download.osgeo.org/osgeo4w/v2/x86_64/

GRASS in QGIS

In order to have GRASS support (also in QGIS-Processing) you need to install the “qgis*-grass-plugin” packages.

Contribute

Please consider a financial contribution to the GRASS project to help us improve and maintain the software.

Docker Images

Installation

Official GRASS Docker images are available on Docker Hub (osgeo/grass-gis). For a list of GRASS versions, see the docker tag list.

Stable images

The following Docker images are generated from the current stable GRASS releasebranch 8.5 :

Alpine based (233 MB, with Python 3 and PDAL)

Install with the following shell command:

docker pull osgeo/grass-gis:releasebranch_8_5-alpine

Debian based (1.2 GB, with Python 3 and PDAL)

Install with the following shell command:

docker pull osgeo/grass-gis:releasebranch_8_5-debian

Ubuntu based (1.2 GB, with Python 3 and PDAL)

Install with the following shell command:

docker pull osgeo/grass-gis:releasebranch_8_5-ubuntu

Ubuntu based (1.3 GB, with wxPython, Python 3 and PDAL)

Install with the following shell command:

docker pull osgeo/grass-gis:releasebranch_8_5-ubuntu_wxgui

Development images

The following Docker images are generated from the GRASS main branch (preview, active development):

Alpine based (236 MB, with Python 3 and PDAL)

Install with the following shell command:

docker pull osgeo/grass-gis:main-alpine

Debian based (1.2 GB, with Python 3 and PDAL)

Install with the following shell command:

docker pull osgeo/grass-gis:main-debian

Ubuntu based (1.2 GB, with Python 3 and PDAL)

Install with the following shell command:

docker pull osgeo/grass-gis:main-ubuntu

Ubuntu based (1.3 GB, with wxPython, Python 3 and PDAL)

Install with the following shell command:

docker pull osgeo/grass-gis:main-ubuntu_wxgui

Run GRASS as a Docker container

Please refer to the GRASS Docker README.

Contribute

Please consider a financial contribution to the GRASS project to help us improve and maintain the software.

GRASS with conda

Installation

The grass package is available on conda-forge for Windows (64-bit), Linux (64-bit), and macOS (Intel and Apple Silicon).

See the conda-forge grass feedstock for packaging details.

To add GRASS into an existing environment:

conda install -c conda-forge grass

If you don’t have an environment yet, create a new environment and install in one step:

conda create -n grass -c conda-forge grass
conda activate grass

Install with mamba

The same works with mamba for faster dependency resolution:

mamba install -c conda-forge grass

Environment file with conda/mamba

To create a reproducible environment, save the following as environment.yml:

name: grass
channels:
  - conda-forge
dependencies:
  - grass

Then create the environment with:

conda env create -f environment.yml
conda activate grass

Install with pixi

For faster dependency across multiple platforms, support for pyproject.toml and environment.yml, and global installation of tools use pixi:

# Installing grass as part of a workspace
pixi init name-of-my-project-using-grass
cd name-of-my-project-using-grass
pixi add grass
# Activates a shell where grass is accessible
pixi shell

If you want to install GRASS as a globally available tool across your system without having to activate an environment:

pixi global install grass

Environment file with pixi

By default, dependencies for the workspace are stored in the pixi.toml file. The pixi.lock file is the machine-readable file that lists all of the dependencies for your workspace.

If you’re using pixi and want to share your environment with conda or mamba users:

pixi workspace export conda-environment environment.yml

Usage

Python

To use GRASS from a Python script in an active conda environment, add the GRASS Python package path to sys.path:

import subprocess
import sys

result = subprocess.run(["grass", "--config", "python_path"],
                        check=True, text=True, capture_output=True)
sys.path.append(result.stdout.strip())

import grass.script as gs

Command line

After activating the conda environment, start GRASS from the command line:

grass

Contribute

Please consider a financial contribution to the GRASS project to help us improve and maintain the software.

Source Code

Compile and install

Source code is available on GitHub. You can download the latest release at https://github.com/OSGeo/grass/releases.

To compile and install GRASS from source, follow these steps from the GRASS wiki.

Contribute

Please consider a financial contribution to the GRASS project to help us improve and maintain the software.