Installation Guide - Revision history

Ltb25: /* Variant B) Advanced installation */

2026-04-15T23:58:04Z

Variant B) Advanced installation

← Older revision		Revision as of 23:58, 15 April 2026
Line 79:		Line 79:
	[[Image:Osgeo4w_2_advanced.png\|center\|thumb\|500px\|Use "Advanced installation" 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]]		[[Image:Osgeo4w_3_advanced.png\|center\|thumb\|500px\| Please note that this image was from a former version of the OSGeo4W installer and GRASS (7.9), so it will look a little different for you now.]]

	Unlike the Express mode, the Advanced Installation mode allows you to specify the directory for installation of the OSGeo4W packages, but the installation will fail if there is a space in the name/path (e.g., Program Files).		Unlike the Express mode, the Advanced Installation mode allows you to specify the directory for installation of the OSGeo4W packages, but the installation will fail if there is a space in the name/path (e.g., Program Files).
Line 85:		Line 85:
	If you plan to use the OSGeo4W installer for future updates on Windows, keep the directory you selected for the installation in mind as the Express mode default is OSGeo4W on the C: drive.		If you plan to use the OSGeo4W installer for future updates on Windows, keep the directory you selected for the installation in mind as the Express mode default is OSGeo4W on the C: drive.

	If there is a problem with the OSGeo4W installation of GRASS, reading the generated log file is useful for identifying and resolving the issue(s).		If there is a problem with the OSGeo4W installation of GRASS, reading the generated log file is useful for identifying and resolving the issue(s).


	=== winGRASS standalone installer ===		=== winGRASS standalone installer ===

Ltb25: /* MS Windows */

2026-04-15T23:50:05Z

MS Windows

← Older revision		Revision as of 23:50, 15 April 2026
Line 12:		Line 12:

	There are two main flavours:		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). Advantages include: 1) Whenever you run the OSGeo4W installer again, it updates the existing installation. 2) The OSGeo4W installer simplifies the installation of GDAL which is needed for some GRASS ~~modules~~.		* '''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). Advantages include: 1) Whenever you run the OSGeo4W installer again, it updates the existing installation. 2) The OSGeo4W installer simplifies the installation of GDAL, which is needed for some GRASS tasks.
	* '''Standalone winGRASS installer''': install GRASS GIS for Windows with the required support packages. Note that if the version of the winGRASS installer does not include the GDAL package, it may be necessary to install it separately for certain GRASS tasks. The OSGeo4W installer is helpful for installing GDAL on Windows.		* '''Standalone winGRASS installer''': install GRASS GIS for Windows with the required support packages. Note that if the version of the winGRASS installer does not include the GDAL package, it may be necessary to install it separately for certain GRASS tasks. The OSGeo4W installer is helpful for installing GDAL on Windows.

	=== OSGeo4W installer ===		=== 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). Advantages include: 1) Whenever you run the OSGeo4W installer again, it updates the existing installation. 2) The OSGeo4W installer simplifies the installation of GDAL which is needed for some GRASS ~~modules~~.		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). Advantages include: 1) Whenever you run the OSGeo4W installer again, it updates the existing installation. 2) The OSGeo4W installer simplifies the installation of GDAL which is needed for some GRASS tasks.

	* Install using [https://trac.osgeo.org/osgeo4w/ OSGeo4W installer] which installs all dependencies as well (PROJ, GDAL, GEOS, Python, etc.)		* Install using [https://trac.osgeo.org/osgeo4w/ OSGeo4W installer] which installs all dependencies as well (PROJ, GDAL, GEOS, Python, etc.)
Line 29:		Line 29:
	(This is because with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and ''do not have administrator privileges'' - even on personal, single-user laptops when the user is also the administrator.)		(This is because with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and ''do not have administrator privileges'' - even on personal, single-user laptops when the user is also the administrator.)

	"The installer must be run on a computer with internet access as the installer downloads individual packages as needed." This means it may be necessary "to enable your software firewall to allow the installer to have outbound access." For example, pausing vpn security features before starting the installation (and for long enough for the duration of the installation).		"The installer must be run on a computer with internet access, as the installer downloads individual packages as needed." This means it may be necessary "to enable your software firewall to allow the installer to have outbound access." For example, pausing vpn security features before starting the installation (and for long enough for the duration of the installation).

	You can select either the grass (stable) or grass-daily (development) packages to install.		You can select either the grass (stable) or grass-daily (development) packages to install.
Line 41:		Line 41:
	[[Image:Osgeo4w_2_express.png\|center\|thumb\|500px\|Use "Express installation" 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]]~~

	For ~~just~~ GRASS GIS installation, select both GRASS and GDAL ~~options~~.		For a GRASS GIS installation, select both GRASS and GDAL.

	The Express Installation will make a directory called OSGeo4W on the C drive and install the packages there. (Note that the options in the 'OSGeo4W Setup - Express Package Selection' box you see with the current version of the OSGeo4W installer you are using may differ from those in the image above.)

	If there is a problem with the OSGeo4W installation ~~of GRASS (either Express or Advanced)~~, reading the generated log file is useful for identifying and resolving the issue(s).		[[Image:Osgeo4w_3_express.png\|center\|thumb\|500px\|The options you see with the current version of the OSGeo4W installer may differ from those in the image above - the important thing is to select both GRASS and GDAL for installation]]

			.

			The Express Installation will make a directory called OSGeo4W on the C drive and install the packages there.

			If there is a problem with the OSGeo4W installation, reading the generated log file is useful for identifying and resolving the issue(s).


Line 64:		Line 68:
	* python3-pywin32		* python3-pywin32

	The "Advanced Install" mode can be used to install additional useful packages (e.g. python3-pandas, msys) ~~for use with the stable GRASS version installed using the "Express Install" mode~~.		The "Advanced Install" mode can be used after an initial "Express Install" to install additional useful packages (e.g. python3-pandas, msys).

	==== Variant B) Advanced installation ====		==== Variant B) Advanced installation ====

	Use "Advanced Install Mode" to customise the installation of the stable version or to install the development version.		Use the "Advanced Install Mode" to customise the installation of the stable version or to install the development version of GRASS. Remember, the OSGeo4W installer should be run as an administrator (right-click to select the Run as administrator option), and internet security features/settings need to allow the installer internet access.

	~~The "Advanced Installation" mode allows more customisation.~~ If ~~you chose to install~~ GRASS and GDAL using the Advanced Installation, do not install ~~everything; be~~ selective~~. The~~ OSGeo4W installer will ~~let~~ you ~~know~~ if ~~there are~~ key dependencies ~~that were not selected~~ and ~~allow you to select them~~ before proceeding with the installation ~~in the Advanced mode~~. ~~Remember, the OSGeo4W installer should be run as an administrator (right-click to select the Run as administrator option).~~		If installing GRASS and GDAL using the Advanced Installation mode, do not attempt a full install (i.e., all options selected). Be selective, knowing that the OSGeo4W installer will alert you if key dependencies are missed and suggest they be added before proceeding with the installation.


Line 77:		Line 81:
	[[Image:Osgeo4w_3_advanced.png\|center\|thumb\|500px]]		[[Image:Osgeo4w_3_advanced.png\|center\|thumb\|500px]]

	Unlike the Express mode, the Advanced Installation mode allows you to specify the directory for installation of the OSGeo4W packages, but the installation will fail if there is a space in the name/path (e.g., Program Files). ~~Keep the directory of the installation in mind if~~ you plan to use the OSGeo4W installer for updates.		Unlike the Express mode, the Advanced Installation mode allows you to specify the directory for installation of the OSGeo4W packages, but the installation will fail if there is a space in the name/path (e.g., Program Files).

			If you plan to use the OSGeo4W installer for future updates on Windows, keep the directory you selected for the installation in mind as the Express mode default is OSGeo4W on the C: drive.

	If there is a problem with the OSGeo4W installation of GRASS ~~(either Express or Advanced)~~, reading the generated log file is useful for identifying and resolving the issue(s).		If there is a problem with the OSGeo4W installation of GRASS, reading the generated log file is useful for identifying and resolving the issue(s).

Ltb25: /* MS Windows */

2026-04-15T23:28:42Z

MS Windows

← Older revision		Revision as of 23:28, 15 April 2026
Line 12:		Line 12:

	There are two main flavours:		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.		* '''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). Advantages include: 1) Whenever you run the OSGeo4W installer again, it updates the existing installation. 2) The OSGeo4W installer simplifies the installation of GDAL which is needed for some GRASS modules.
	* '''Standalone winGRASS installer''': install GRASS GIS with the required support packages.		* '''Standalone winGRASS installer''': install GRASS GIS for Windows with the required support packages. Note that if the version of the winGRASS installer does not include the GDAL package, it may be necessary to install it separately for certain GRASS tasks. The OSGeo4W installer is helpful for installing GDAL on Windows.

	=== OSGeo4W installer ===		=== 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.		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). Advantages include: 1) Whenever you run the OSGeo4W installer again, it updates the existing installation. 2) The OSGeo4W installer simplifies the installation of GDAL which is needed for some GRASS modules.

	* Install using [https://trac.osgeo.org/osgeo4w/ OSGeo4W installer] which installs all dependencies as well (PROJ, GDAL, GEOS, Python, etc.)		* Install using [https://trac.osgeo.org/osgeo4w/ OSGeo4W installer] which installs all dependencies as well (PROJ, GDAL, GEOS, Python, etc.)
Line 23:		Line 23:
	==== Launch the OSGeo4W installer ====		==== Launch the OSGeo4W installer ====

	Save the downloaded installer (consider keeping it for future updates) ~~and run it as an ''administrator''~~.		Save and run the downloaded installer as an ''administrator'' (consider keeping it for convenient future updates).

	(~~Note that~~ with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and ''do not have administrator privileges'' - even on personal, single-user laptops when the user is also the administrator. To run the installer as ~~an administrator from a location in a standard user account directory~~, ~~right-click on~~ the ~~installer~~ and ~~select Run as administrator~~.)		To ensure you are running the OSGeo4W installer as an administrator, it is recommended to right-click on the installer and select ''Run as administrator ''(rather than opening/running it directly, e.g. left-clicking or double-clicking).

			(This is because with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and ''do not have administrator privileges'' - even on personal, single-user laptops when the user is also the administrator.)

			"The installer must be run on a computer with internet access as the installer downloads individual packages as needed." This means it may be necessary "to enable your software firewall to allow the installer to have outbound access." For example, pausing vpn security features before starting the installation (and for long enough for the duration of the installation).

	You can select either the grass (stable) or grass-daily (development) packages to install.		You can select either the grass (stable) or grass-daily (development) packages to install.
Line 33:		Line 37:
	==== Variant A) Express installation ====		==== Variant A) Express installation ====

	~~Use~~ "Express Desktop Install" mode ~~to select~~ stable version.		The "Express Desktop Install" mode installs the stable version of GRASS. The OSGeo4W Quick Start guidance recommends running the "Express Installation" over a 'full install in Advanced mode'.

	[[Image:Osgeo4w_2_express.png\|center\|thumb\|500px\|Use "Express installation" to select stable version]]		[[Image:Osgeo4w_2_express.png\|center\|thumb\|500px\|Use "Express installation" to select stable version]]
Line 39:		Line 43:
	[[Image:Osgeo4w_3_express.png\|center\|thumb\|500px]]		[[Image:Osgeo4w_3_express.png\|center\|thumb\|500px]]

	~~Common~~ installed Python packages:		For just GRASS GIS installation, select both GRASS and GDAL options.

			The Express Installation will make a directory called OSGeo4W on the C drive and install the packages there. (Note that the options in the 'OSGeo4W Setup - Express Package Selection' box you see with the current version of the OSGeo4W installer you are using may differ from those in the image above.)

			If there is a problem with the OSGeo4W installation of GRASS (either Express or Advanced), reading the generated log file is useful for identifying and resolving the issue(s).


			Commonly installed Python packages include:

	* python3-gdal		* python3-gdal
Line 53:		Line 64:
	* python3-pywin32		* python3-pywin32

	~~Additional~~ useful packages (e.g. python3-pandas, msys) ~~can be~~ installed in "~~Advanced~~ Install" mode.		The "Advanced Install" mode can be used to install additional useful packages (e.g. python3-pandas, msys) for use with the stable GRASS version installed using the "Express Install" mode.

	==== Variant B) Advanced installation ====		==== Variant B) Advanced installation ====

	Use "Advanced Install Mode" to ~~select~~ development version.		Use "Advanced Install Mode" to customise the installation of the stable version or to install the development version.

			The "Advanced Installation" mode allows more customisation. If you chose to install GRASS and GDAL using the Advanced Installation, do not install everything; be selective. The OSGeo4W installer will let you know if there are key dependencies that were not selected and allow you to select them before proceeding with the installation in the Advanced mode. Remember, the OSGeo4W installer should be run as an administrator (right-click to select the Run as administrator option).


	[[Image:Osgeo4w_2_advanced.png\|center\|thumb\|500px\|Use "Advanced installation" 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]]		[[Image:Osgeo4w_3_advanced.png\|center\|thumb\|500px]]

			Unlike the Express mode, the Advanced Installation mode allows you to specify the directory for installation of the OSGeo4W packages, but the installation will fail if there is a space in the name/path (e.g., Program Files). Keep the directory of the installation in mind if you plan to use the OSGeo4W installer for updates.

			If there is a problem with the OSGeo4W installation of GRASS (either Express or Advanced), reading the generated log file is useful for identifying and resolving the issue(s).


	=== winGRASS standalone installer ===		=== winGRASS standalone installer ===

Ltb25: /* Launch the OSGeo4W installer */

2026-04-08T15:38:56Z

Launch the OSGeo4W installer

← Older revision		Revision as of 15:38, 8 April 2026
Line 25:		Line 25:
	Save the downloaded installer (consider keeping it for future updates) and run it as an ''administrator''.		Save the downloaded installer (consider keeping it for future updates) and run it as an ''administrator''.

	(Note that with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and do not have administrator privileges'' - even on personal, single-user laptops when the user is also the administrator. To run the installer as an administrator from a location in a standard user account directory, right-click on the installer and select Run as administrator.)		(Note that with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and ''do not have administrator privileges'' - even on personal, single-user laptops when the user is also the administrator. To run the installer as an administrator from a location in a standard user account directory, right-click on the installer and select Run as administrator.)

	You can select either the grass (stable) or grass-daily (development) packages to install.		You can select either the grass (stable) or grass-daily (development) packages to install.

Ltb25: /* Launch the OSGeo4W installer */

2026-04-08T15:36:52Z

Launch the OSGeo4W installer

← Older revision		Revision as of 15:36, 8 April 2026
Line 25:		Line 25:
	Save the downloaded installer (consider keeping it for future updates) and run it as an ''administrator''.		Save the downloaded installer (consider keeping it for future updates) and run it as an ''administrator''.

	(Note that with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default ~~which does~~ not have administrator privileges'' - even on personal, single-user laptops when the user is also the administrator. To run the installer as an administrator from a location in a standard user account directory, right-click on the installer and select Run as administrator.)		(Note that with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and do not have administrator privileges'' - even on personal, single-user laptops when the user is also the administrator. To run the installer as an administrator from a location in a standard user account directory, right-click on the installer and select Run as administrator.)

	You can select either the grass (stable) or grass-daily (development) packages to install.		You can select either the grass (stable) or grass-daily (development) packages to install.

Ltb25: /* Launch the OSGeo4W installer */

2026-04-08T15:36:02Z

Launch the OSGeo4W installer

← Older revision		Revision as of 15:36, 8 April 2026
Line 25:		Line 25:
	Save the downloaded installer (consider keeping it for future updates) and run it as an ''administrator''.		Save the downloaded installer (consider keeping it for future updates) and run it as an ''administrator''.

	(Note that with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default ~~and ''do~~ not have administrator privileges'' ~~by default~~ - even on personal, single-user laptops. ~~Make sure to use~~ an administrator ~~rather than~~ standard user account ~~when running~~ the installer)		(Note that with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default which does not have administrator privileges'' - even on personal, single-user laptops when the user is also the administrator. To run the installer as an administrator from a location in a standard user account directory, right-click on the installer and select Run as administrator.)

	You can select either the grass (stable) or grass-daily (development) packages to install.		You can select either the grass (stable) or grass-daily (development) packages to install.

Ltb25: /* Launch the OSGeo4W installer */

2026-04-08T03:42:47Z

Launch the OSGeo4W installer

← Older revision		Revision as of 03:42, 8 April 2026
Line 25:		Line 25:
	Save the downloaded installer (consider keeping it for future updates) and run it as an ''administrator''.		Save the downloaded installer (consider keeping it for future updates) and run it as an ''administrator''.

	(Note that with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and ''do not have administrator privileges'' by default - even on personal, single-user laptops. ~~To run the installer, move it~~ to an ~~Administrator-Only directory, e.g. C:\Program Files, or adjust the User Account Control (UAC) settings to Administrator for the~~ user's account ~~it is in, first~~)		(Note that with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and ''do not have administrator privileges'' by default - even on personal, single-user laptops. Make sure to use an administrator rather than standard user account when running the installer)

	You can select either the grass (stable) or grass-daily (development) packages to install.		You can select either the grass (stable) or grass-daily (development) packages to install.

Ltb25: /* Launch the OSGeo4W installer */

2026-04-08T03:32:44Z

Launch the OSGeo4W installer

← Older revision		Revision as of 03:32, 8 April 2026
Line 25:		Line 25:
	Save the downloaded installer (consider keeping it for future updates) and run it as an ''administrator''.		Save the downloaded installer (consider keeping it for future updates) and run it as an ''administrator''.

	(Note that with Windows 11 the ''desktop'', ''download'', and ''documents''directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and ''do not have administrator privileges'' by default - even on personal, single-user laptops. To run the installer, move it to an Administrator-Only directory, e.g. C:\Program Files, or adjust the User Account Control (UAC) settings to Administrator for the user's account it is in, first)		(Note that with Windows 11 the ''desktop'', ''download'', and ''documents'' directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and ''do not have administrator privileges'' by default - even on personal, single-user laptops. To run the installer, move it to an Administrator-Only directory, e.g. C:\Program Files, or adjust the User Account Control (UAC) settings to Administrator for the user's account it is in, first)

	You can select either the grass (stable) or grass-daily (development) packages to install.		You can select either the grass (stable) or grass-daily (development) packages to install.

Ltb25: /* OSGeo4W installer */

2026-04-08T03:31:31Z

OSGeo4W installer

← Older revision		Revision as of 03:31, 8 April 2026
Line 20:		Line 20:

	* Install using [https://trac.osgeo.org/osgeo4w/ OSGeo4W installer] which installs all dependencies as well (PROJ, GDAL, GEOS, Python, etc.)		* Install using [https://trac.osgeo.org/osgeo4w/ OSGeo4W installer] which installs all dependencies as well (PROJ, GDAL, GEOS, Python, etc.)

			==== Launch the OSGeo4W installer ====

	~~==== Launch~~ the ~~OSGeo4W~~ installer ~~====~~		Save the downloaded installer (consider keeping it for future updates) and run it as an ''administrator''.

			(Note that with Windows 11 the ''desktop'', ''download'', and ''documents''directories are located in a standard user account directory, e.g. C:\User\username, that is created by default and ''do not have administrator privileges'' by default - even on personal, single-user laptops. To run the installer, move it to an Administrator-Only directory, e.g. C:\Program Files, or adjust the User Account Control (UAC) settings to Administrator for the user's account it is in, first)

	~~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.
	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]]		[[Image:Osgeo4w_1.png\|center\|thumb\|500px\|Install with "Administrator" rights]]

Neteler: /* Installation on Fedora */

2024-07-30T20:03:49Z

Installation on Fedora

← Older revision		Revision as of 20:03, 30 July 2024
Line 89:		Line 89:
	=== Installation on Fedora ===		=== Installation on Fedora ===

	[https://~~admin~~.fedoraproject.org/~~pkgdb/acls/name~~/grass ~~Fedoraproject~~] provides RPM-packages for stable releases prepared to install on Fedora systems:		The [https://src.fedoraproject.org/rpms/grass Fedora project] provides RPM-packages for stable releases prepared to install on Fedora systems:

	<source lang="bash">		<source lang="bash">