Download
GRASS for Linux
Support UsInstallation
Install the grass package on your Linux distribution. Have a look at
Repology for an extended
list of GRASS packages or directly check the
packaging status
to quickly know which GRASS version is currently available for your distro.
Ubuntu
Add the ubuntugis-unstable PPA to your system:
sudo add-apt-repository ppa:ubuntugis/ubuntugis-unstableUpdate your package list:
sudo apt updateInstall with the following shell command:
sudo apt install grassFor more information visit ubuntugis-unstable.
Generic 64-bit
Download the latest weekly GRASS binary snapshot from https://grass.osgeo.org/grass85/binary/linux/snapshot/ and make it executable:
chmod +x grass-*-x86_64-pc-linux-gnu-*-install.shInstall with the following shell command:
sh grass-*-x86_64-pc-linux-gnu-*-install.shFor more information visit snapshots.
Debian
Install with the following shell command:
sudo apt install grassFor more information visit debian packages.
Fedora
Install with the following shell command:
sudo dnf install grassFor more information visit Fedora packages.
Arch Linux
Install with the following shell command:
sudo pacman -S grassFor more information visit Arch Linux packages.
EPEL8
Install with the following shell command:
sudo yum install grassFor more information visit EPEL8 (RHEL8/Centos8) packages.
Gentoo
Install with the following shell command:
sudo emerge -av sci-geosciences/grassFor more information visit Gentoo packages.
Mageia
Install with the following shell command:
sudo dnf install grassFor more information visit Mageia packages.
openSUSE
Install with the following shell command:
sudo zypper install grassFor more information visit openSUSE packages.
Compile and Install
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.
Support UsDownload GRASS for macOS
Click the button below to download the latest macOS version of GRASS.
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 grassFor 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.
Support UsDownload GRASS for Windows
Click the button below to download the latest Windows version of GRASS.
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.
Support UsDocker Images
Support GRASSInstallation
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-alpineDebian based (1.2 GB, with Python 3 and PDAL)
Install with the following shell command:
docker pull osgeo/grass-gis:releasebranch_8_5-debianUbuntu based (1.2 GB, with Python 3 and PDAL)
Install with the following shell command:
docker pull osgeo/grass-gis:releasebranch_8_5-ubuntuUbuntu 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_wxguiDevelopment 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-alpineDebian based (1.2 GB, with Python 3 and PDAL)
Install with the following shell command:
docker pull osgeo/grass-gis:main-debianUbuntu based (1.2 GB, with Python 3 and PDAL)
Install with the following shell command:
docker pull osgeo/grass-gis:main-ubuntuUbuntu based (1.3 GB, with wxPython, Python 3 and PDAL)
Install with the following shell command:
docker pull osgeo/grass-gis:main-ubuntu_wxguiRun 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.
Support UsGRASS with conda
Support GRASSInstallation
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.
Support UsSource Code
Support GRASSCompile 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.
Support Us