# 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](/docs/2.3/user/qswat+.md) 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](/docs/2.3/release-notes.md) 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*](/docs/2.3/installation.md#swat-sqlite-datasets) *section below as they are not included in the installers. See detailed installation instructions for Linux and MacOS* [*here*](/docs/2.3/get-help/linux-and-macos.md)*.*&#x20;

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

{% content-ref url="/pages/-LZpijLq66ISF5uJbCGa" %}
[Release Notes](/docs/2.3/release-notes.md)
{% endcontent-ref %}

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

{% content-ref url="/pages/-Lj2AdbFvw0yZ04BLFmb" %}
[Troubleshooting](/docs/2.3/get-help/troubleshooting.md)
{% 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="/files/obb8ykLhYHZKRWPnRoJE" %}
Windows 64bit - SWAT+ rev. 60.5.7
{% endfile %}

{% file src="/files/jexdQZryL5WUWXYlu5T7" %}
Linux 64bit - SWAT+ rev. 60.5.7
{% endfile %}

{% file src="/files/55nwQmFtUGsxAMGhPSfF" %}
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).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://swatplus.gitbook.io/docs/2.3/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.