> For the complete documentation index, see [llms.txt](https://swatplus.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://swatplus.gitbook.io/docs/installation.md).
# Installation
{% hint style="success" %}
Prefer a video guide instead? [Watch how to install our tools on YouTube.](https://youtu.be/2oBnX5MtJIg)
{% endhint %}
## 1. Install QGIS 3.44
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**. Use the default folder `C:\Program Files\QGIS 3.44.n` as the installation folder. See the [QSWAT+ manual](/docs/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+ 4.0 Installer
This release includes **SWAT+ rev. 62**, **QSWAT+ 4.0**, **SWAT+ Editor 4.0**, and **SWAT+ Toolbox 4.0**. To install the SWAT+ model and interface components, please use an installer linked below for your operating system. Administrator privileges are not required for personal installations (but Mac requires use of sudo).
Existing SWAT+ users should be sure to read the [release notes](/docs/release-notes.md) thoroughly to see how the software updates affect your projects.
#### Windows 64-bit
Download SWAT+ 4.0 for Windows
*Released 16 June 2026*
#### Linux and MacOS
Click the tabs to install each component with the commands below.
{% tabs %}
{% tab title="QSWAT+" %}
Installs the QSWAT+ QGIS plugin into your QGIS profiles, plus the SWAT+ support data and a self-contained TauDEM. Re-run any time to update.
```sh
curl -fsSL https://install.swatplus.link/qsp.sh | bash
```
{% endtab %}
{% tab title="SWAT+ Editor" %}
Installs to \~/.local/share/SWATPlus/SWATPlusEditor and self-updates. Re-run any time to update.
```shellscript
curl -fsSL https://install.swatplus.link/spe.sh | bash
```
{% endtab %}
{% tab title="SWAT+ Toolbox" %}
Installs to \~/.local/share/SWATPlus/SWATPlusToolbox and self-updates. Re-run any time to update.
```shellscript
curl -fsSL https://install.swatplus.link/spt.sh | bash
```
{% endtab %}
{% endtabs %}
Trouble loading the software after installation? Read through our troubleshooting guide.
{% content-ref url="/pages/-Lj2AdbFvw0yZ04BLFmb" %}
[Troubleshooting](/docs/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://github.com/swat-model/QSWATPlus/releases)
* [SWAT+ Editor Installers](https://github.com/swat-model/swatplus-editor/releases)
* [SWAT+ Toolbox Installers](https://celray.github.io/SWATPlusToolbox)
### 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 at the SWAT+ Github repository.
* [SWAT+ model releases](https://github.com/swat-model/swatplus/releases)
## 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://plus.swat.tamu.edu/downloads/3.2/swatplus_datasets.sqlite)
* [SWAT+ global weather generator data](https://plus.swat.tamu.edu/downloads/swatplus_wgn.zip)
* [SWAT+ US SSURGO/STATSGO soil data](https://plus.swat.tamu.edu/downloads/swatplus_soils.zip)
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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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/installation.md?ask=
```
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.