---

title: Downloading SU2

layout: default

---

<div class="container">

<div class="row">

<div class="col-lg-12 text-center">

<img src="img/hl_crm_03.png" alt="" class="img-responsive">

</div>

<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>

<script>

$(document).ready (function () {

$.getJSON("https://api.github.com/repos/su2code/SU2/releases/latest").done(function (data) {

$ ('#current_release').text ("Current Release: " + data.name);

$ ('#html_url').attr("href", data.html_url)

$ ('#zip_ball').attr("href", data.zipball_url)

$ ('#tar_ball').attr("href", data.tarball_url)

for (var key in data.assets) {

if (data.assets[key].name.includes("linux64.zip")) {

$('#asset_linux').attr("href",data.assets[key].browser_download_url)

$('#asset_linux').text("SU2 " + data.tag_name + " for Linux")

$('#asset_linux_time').text(data.assets[key].created_at.substring(0, 10))

$('#asset_linux_size').text(parseInt(data.assets[key].size/1024/1024) + 'MB')

$('#asset_linux_count').text(data.assets[key].download_count)

}

if (data.assets[key].name.includes("linux64-mpi.zip")) {

$('#asset_linux_mpi').attr("href",data.assets[key].browser_download_url)

$('#asset_linux_mpi').text("SU2 MPI " + data.tag_name + " for Linux")

$('#asset_linux_mpi_time').text(data.assets[key].created_at.substring(0, 10))

$('#asset_linux_mpi_size').text(parseInt(data.assets[key].size/1024/1024) + 'MB')

$('#asset_linux_mpi_count').text(data.assets[key].download_count)

}

if (data.assets[key].name.includes("macos64.zip")) {

$('#asset_mac').attr("href",data.assets[key].browser_download_url)

$('#asset_mac').text("SU2 " + data.tag_name + " for macOS")

$('#asset_mac_time').text(data.assets[key].created_at.substring(0, 10))

$('#asset_mac_size').text(parseInt(data.assets[key].size/1024/1024) + 'MB')

$('#asset_mac_count').text(data.assets[key].download_count)

}

if (data.assets[key].name.includes("macos64-mpi.zip")) {

$('#asset_mac_mpi').attr("href",data.assets[key].browser_download_url)

$('#asset_mac_mpi').text("SU2 MPI " + data.tag_name + " for macOS")

$('#asset_mac_mpi_time').text(data.assets[key].created_at.substring(0, 10))

$('#asset_mac_mpi_size').text(parseInt(data.assets[key].size/1024/1024) + 'MB')

$('#asset_mac_mpi_count').text(data.assets[key].download_count)

}

if (data.assets[key].name.includes("win64.zip")) {

$('#asset_win').attr("href",data.assets[key].browser_download_url)

$('#asset_win').text("SU2 " + data.tag_name + " for Windows")

$('#asset_win_time').text(data.assets[key].created_at.substring(0, 10))

$('#asset_win_size').text(parseInt(data.assets[key].size/1024/1024) + 'MB')

$('#asset_win_count').text(data.assets[key].download_count)

}

if (data.assets[key].name.includes("win64-mpi.zip")) {

$('#asset_win_mpi').attr("href",data.assets[key].browser_download_url)

$('#asset_win_mpi').text("SU2 MPI " + data.tag_name + " for Windows")

$('#asset_win_mpi_time').text(data.assets[key].created_at.substring(0, 10))

$('#asset_win_mpi_size').text(parseInt(data.assets[key].size/1024/1024) + 'MB')

$('#asset_win_mpi_count').text(data.assets[key].download_count)

}

}

})

$.getJSON("https://api.github.com/repos/su2code/Tutorials/releases/latest").done(function (data) {

$ ('#zip_ball_tut').attr("href", data.zipball_url)

$ ('#tar_ball_tut').attr("href", data.tarball_url)

})

$.getJSON("https://api.github.com/repos/su2code/TestCases/releases/latest").done(function (data) {

$ ('#zip_ball_test').attr("href", data.zipball_url)

$ ('#tar_ball_test').attr("href", data.tarball_url)

})

});

console.log(jQuery.getJSON("https://api.github.com/repos/su2code/SU2/releases/latest"))

</script>

<div class="row">

<div class="col-lg-12">

<h1 class="text-center">Downloading SU2</h1>

<br>

<p>SU2 is available freely for use under the GNU Lesser General Public License, version 2.1. Please reference the <a href="https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html">license details</a> for terms and conditions.</p>

<p> Before downloading the software, please take a moment to register for the <a href="http://su2foundation.org">email list</a>, so you won't miss out on the latest news and announcements from the SU2 project. We respect your privacy, and the information we collect is used only for statistics and never shared. Your participation lets us build a better tool to suit the needs of our community.</p>

<br>

<script charset="utf-8" type="text/javascript" src="//js.hsforms.net/forms/shell.js"></script>

<script>

hbspt.forms.create({

portalId: "5843759",

formId: "c7533ebd-39d6-4fa4-81eb-ad6d108f86b7"

});

</script>

<br>

<hr>

<h2>Binary Executables</h2>

<p>This option is for users who wish to use SU2 without the need to compile the program from source. We provide serial and parallel (using MPI) versions. </p>

<b>Disclaimer:</b> For best performance and compatibility you should always consider building SU2 from source. Also note that the Discrete Adjoint functionality is not available when using the binary executables.

<br>

<br>

After downloading the appropriate files for your OS, make sure to check out the installation guides (<a href = "/docs_v7/SU2-Linux-MacOS/">Linux/MacOS</a>, <a href="/docs_v7/SU2-Windows/">Windows</a>) and the <a href="/docs_v7/Quick-Start">QuickStart</a> case.

</div>

<br>

<h3 id="current_release"></h3>

<h4>Release Notes can be found on the <a href="https://github.com/su2code/SU2/releases">releases page on Github</a></h4>

<br>

<table style='width:100%;font-size:100%;'>

<tr>

<th><h4>Version</h4></th>

<th><h4>Notes</h4></th>

<th><h4>Published</h4></th>

<th><h4>Downloads</h4></th>

<th><h4>Size</h4></th>

</tr>

<tr>

<td><a class="btn btn-info btn-lg" style="width: 280px;" id="asset_linux" role="button">SU2 for Linux</a></td>

<td>-</td>

<td><p id="asset_linux_time"></p></td>

<td><p id="asset_linux_count"></p></td>

<td><p id="asset_linux_size"></p></td>

</tr>

<tr>

<td>&nbsp;</td>

</tr>

<tr>

<td><a class="btn btn-info btn-lg" style="width: 280px;"id="asset_linux_mpi" role="button">SU2 MPI for Linux</a></td>

<td>Requires installation of <a href="https://www.mpich.org/downloads/">MPICH</a></td>

<td><p id="asset_linux_mpi_time"></p></td>

<td><p id="asset_linux_mpi_count"></p></td>

<td><p id="asset_linux_mpi_size"></p></td>

</tr>

<tr>

<td>&nbsp;</td>

</tr>

<tr>

<td><a class="btn btn-success btn-lg" style="width: 280px;" id="asset_mac" role="button">SU2 for macOS</a></td>

<td>-</td>

<td><p id="asset_mac_time"></p></td>

<td><p id="asset_mac_count"></p></td>

<td><p id="asset_mac_size"></p></td>

</tr>

<tr>

<td>&nbsp;</td>

</tr>

<tr>

<td><a class="btn btn-success btn-lg" style="width: 280px;" id="asset_mac_mpi" role="button">SU2 MPI macOS</a></td>

<td>Requires installation of <a href="https://www.mpich.org/downloads/">MPICH</a></td>

<td><p id="asset_mac_mpi_time"></p></td>

<td><p id="asset_mac_mpi_count"></p></td>

<td><p id="asset_mac_mpi_size"></p></td>

</tr>

<tr>

<td>&nbsp;</td>

</tr>

<tr>

<td><a class="btn btn-danger btn-lg" style="width: 280px;" id="asset_win" role="button">SU2 for Windows</a></td>

<td>-</td>

<td><p id="asset_win_time"></p></td>

<td><p id="asset_win_count"></p></td>

<td><p id="asset_win_size"></p></td>

</tr>

<tr>

<td>&nbsp;</td>

</tr>

<tr>

<td><a class="btn btn-danger btn-lg" style="width: 280px;" id="asset_win_mpi" role="button">SU2 MPI for Windows</a></td>

<td>Requires installation of <a href="https://www.microsoft.com/en-us/download/details.aspx?id=100593">Microsoft MPI</a></td>

<td><p id="asset_win_mpi_time"></p></td>

<td><p id="asset_win_mpi_count"></p></td>

<td><p id="asset_win_mpi_size"></p></td>

</tr>

</table>

<h2>Source Code</h2>

<p>There are a number of ways to access the SU2 source code. If you will be developing the code, we recommend that you clone the repository. On a Linux/Unix/Mac system with the standard git client, this can be done by executing:</p>

<p><code>$ git clone https://github.com/su2code/SU2.git</code></p>

<p>You may also browse the code on <a href="https://github.com/su2code/SU2">GitHub</a> directly. A link on the right hand side provides the option to download a current snapshot of the master branch repository as a ZIP file. The latest release will also be tagged and available on the GitHub <a href="https://github.com/su2code/SU2/releases">releases page</a>, and for convenience, you can download the this source code from the latest release directly with the button below:</p>

<div class="row">

<div class="col-sm-3 text-center">

<p><a class="btn btn-primary btn-lg" id="zip_ball" role="button">Source (.zip)</a></p>

</div>

<div class="col-sm-3 text-center">

<p><a class="btn btn-primary btn-lg" id="tar_ball" role="button">Source (.tar.gz)</a></p>

</div>

</div>

<p>Once you have obtained a copy of the code, follow the installation instructions for <a href="/docs_v7/Build-SU2-Linux-MacOS/">Linux/MacOS</a> or for <a href="/docs_v7/Build-SU2-Linux-MacOS/">Windows</a> to compile and install from source.</p>

<h2>Previous Versions</h2>

<p>SU2 is hosted on GitHub, and previous versions are tagged and available on the <a href="https://github.com/su2code/SU2/releases">releases page</a>.</p>

<h2>Tutorials</h2>

<p>As part of our documentation and training, we ship a set of <a href="/tutorials/home/">tutorials</a> that walk the user through setting up and executing a number of examples. These cases start from the basics and help the user learn SU2 quickly. Later tutorials cover advanced SU2 capabilities, such as optimal shape design.</p>

You can get the most recent config and mesh files using the following links:

<div class="row">

<div class="col-sm-3 text-center">

<p><a class="btn btn-info btn-lg" id="zip_ball_tut" role="button">Web Tutorials (.zip)</a></p>

</div>

<div class="col-sm-3 text-center">

<p><a class="btn btn-info btn-lg" id="tar_ball_tut" role="button">Web Tutorials (.tar.gz)</a></p>

</div>

</div>

<p>Or you can directly clone the repository:</p>

<p><code>$ git clone https://github.com/su2code/Tutorials</code></p>

<h2>Test Case Suite</h2>

<p>SU2 comes with an extensive collection of common test cases. The test cases contain meshes and configuration files that can be run to ensure different components of the suite are working properly. Test cases (configuration and mesh files) are included in a separate repository, also available on <a href="https://github.com/su2code/TestCases">GitHub</a> that can be accessed using:</p>

<p><code>$ git clone https://github.com/su2code/TestCases.git</code></p>

The latest release of the test cases will also be tagged and available on the GitHub <a href="https://github.com/su2code/TestCases/releases">releases page</a>, and for convenience, you can download the this source code from the latest release directly with the button below:</p>

<div class="row" style="display:block; margin: 0 auto">

<div class="col-sm-3 text-center">

<p><a class="btn btn-success btn-lg" id="zip_ball_test" role="button">Test Cases (.zip)</a></p>

</div>

<div class="col-sm-3 text-center">

<p><a class="btn btn-success btn-lg" id="tar_ball_test" role="button">Test Cases (.tar.gz)</a></p>

</div>

</div>

<p>Note that, while many of the cases are used for regression testing, this test case suite is provided <b>without any guarantees on performance or expected results</b>. Keep in mind that small changes to the configuration options can often result in large changes to the output. We encourage the community to experiment with these test cases, or even try (and share!) other interesting validation cases with SU2!</p>

<p> Please see the documentation on <a href="/docs_v7/Test-Cases/">how to use the test cases</a>.</p>

</div>

</div>