# Installation

## 1. Install QGIS 3.28

{% hint style="danger" %}
There is a problem with versions of QGIS after 3.22 and before 3.28.13 that causes errors in QSWAT+. Please make sure you do not use such a version.
{% endhint %}

If you plan to use QSWAT+ to set up your watershed, please install QGIS 3 before installing SWAT+. It can be downloaded from the [QGIS download page](https://www.qgis.org/en/site/forusers/download.html), where you should select the **Long term release repository**, and the **64 bit standalone installer**. Version 3.28 is recommended. Use the default folder `C:\Program Files\QGIS 3.28.n` as the installation folder. See the [QSWAT+ manual](https://swatplus.gitbook.io/docs/2.3/user/qswat+) for further instructions. 

* **MacOS and Linux only:** users will need to install openmpi separately. 
  * MacOS: run `brew install openmpi` from a terminal.
  * Linux Ubuntu: run `sudo apt-get install openmpi-bin` from a terminal. \
    Package name may vary with distribution.

## 2. SWAT+ 2.3 Installer

{% hint style="warning" %}
If you have a version of SWAT+ Editor earlier than **2.3.1**, we recommend updating due to an issue in aquifer routing that would affect your model's hydrology. See the [release notes](https://swatplus.gitbook.io/docs/2.3/release-notes) for details.
{% endhint %}

This release includes **SWAT+ rev. 60.5.7**, **QSWAT+ 2.4**, **SWAT+ Editor 2.3**, and **SWAT+ Toolbox 1.0.5 (Windows only)**. To install the SWAT+ model and interface components, please use an installer linked below for your operating system. The installer is for 64-bit machines. Administrator privileges are not required for personal installations (but Mac requires use of sudo).

<table><thead><tr><th width="246.30748299319728">Operating System</th><th width="192">Link</th><th width="180">Release Date</th><th>Version</th></tr></thead><tbody><tr><td>Windows 64-bit</td><td><a href="https://plus.swat.tamu.edu/downloads/2.3/2.3.7/swatplus-windows-installer-2.3.7.zip">Download (373 MB)</a></td><td>4 October 2023</td><td>2.3.7</td></tr><tr><td>*Linux 64-bit</td><td><a href="https://plus.swat.tamu.edu/downloads/2.3/2.3.1/swatplus-linux-installer-2.3.1.tgz">Download (208 MB)</a> </td><td>13 July 2023</td><td>2.3.1</td></tr><tr><td>*MacOS Intel 64-bit</td><td><a href="https://plus.swat.tamu.edu/downloads/2.3/2.3.1/swatplus-mac-installer-2.3.1.tgz">Download (387 MB)</a></td><td>3 August 2023</td><td>2.3.1</td></tr><tr><td>*MacOS Arm M1/M2</td><td><a href="https://plus.swat.tamu.edu/downloads/2.3/2.3.1/swatplus-mac-arm-installer-2.3.1.tgz">Download (213 MB)</a></td><td>11 August 2023</td><td>2.3.1</td></tr></tbody></table>

*\*For Linux and MacOS, the optional SSURGO/STATSGO soils and WGN databases should be downloaded from the* [*SWAT+ SQLite Datasets*](#swat-sqlite-datasets) *section below as they are not included in the installers. See detailed installation instructions for Linux and MacOS* [*here*](https://swatplus.gitbook.io/docs/2.3/get-help/linux-and-macos)*.*&#x20;

Existing SWAT+ users should be sure to read the [release notes](https://swatplus.gitbook.io/docs/2.3/release-notes) thoroughly to see how the software updates affect your projects.

{% content-ref url="release-notes" %}
[release-notes](https://swatplus.gitbook.io/docs/2.3/release-notes)
{% endcontent-ref %}

Trouble loading the software after installation? Read through our troubleshooting guide.

{% content-ref url="get-help/troubleshooting" %}
[troubleshooting](https://swatplus.gitbook.io/docs/2.3/get-help/troubleshooting)
{% endcontent-ref %}

## Individual Component Installation

If you need to install QSWAT+ or SWAT+ Editor individually, grab the latest release of their respective installers from their source code repository downloads page.

* [QSWAT+ Installers](https://bitbucket.org/christophergeorge/qswatplus3/downloads/)
* [SWAT+ Editor Installers](https://plus.swat.tamu.edu/)
* [SWAT+ Toolbox Installer](https://swat.tamu.edu/software/plus/)

### SWAT+ Model (Command Line Executable)

The model itself is packaged with SWAT+ Editor and we recommend using the editor to modify your inputs and run the model. However, if you would like to download just the command line executable file, it is available below.

{% file src="<https://4217724086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT47EY0rpheOA7rIcPNO2%2Fuploads%2FOIUyEUsX7fAhq9BSPw2w%2Frev60.5.7_windows.zip?alt=media&token=6c2d6dfb-8450-481c-aab7-191fb8180870>" %}
Windows 64bit - SWAT+ rev. 60.5.7
{% endfile %}

{% file src="<https://4217724086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT47EY0rpheOA7rIcPNO2%2Fuploads%2FBMTKlLglpv9oTf40Owv9%2Frev60.5.7_linux.zip?alt=media&token=292cfb33-6f4d-4671-b325-3d839ba091d6>" %}
Linux 64bit - SWAT+ rev. 60.5.7
{% endfile %}

{% file src="<https://4217724086-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT47EY0rpheOA7rIcPNO2%2Fuploads%2FBwV3LfEE5A3FHionBEaW%2Frev60.5.7_mac.zip?alt=media&token=5316d1a9-0db4-4904-beda-d45a8a097588>" %}
MacOS 64bit - SWAT+ rev. 60.5.7
{% endfile %}

## SWAT+ SQLite Datasets

On Windows we recommend using the SWAT+ Tools installer above for installing the SWAT+ datasets databases to their proper locations. However, for Linux and MacOS, or if you need to access these components individually, they are linked below:

* [SWAT+ datasets](https://bitbucket.org/swatplus/swatplus.editor/downloads/swatplus_datasets.sqlite)
* [SWAT+ global weather generator data](https://bitbucket.org/swatplus/swatplus.editor/downloads/swatplus_wgn.sqlite)
* [SWAT+ US SSURGO/STATSGO soil data](https://bitbucket.org/swatplus/swatplus.editor/downloads/swatplus_soils.sqlite)

These files should be placed in `SWATPlus/Databases`

## Previous Versions

Previous releases may be accessed from [plus.swat.tamu.edu](https://plus.swat.tamu.edu).