# Installation

{% hint style="success" %}
For the sake of organization, it's recommended that you make a Gauntlet folder (e.g. `Gauntlet test`) to put the gauntlet executable in, along with your `.gaunt` files.
{% endhint %}

{% hint style="warning" %}
Go must be installed on your computer for Gauntlet to work
{% endhint %}

## Installing Gauntlet

{% stepper %}
{% step %}
### Head to the [GitHub Releases page](https://github.com/gauntlet-lang/gauntlet/releases) and download for your OS

* The GitHub Releases page is the only official source for distributing Gauntlet
* Linux, Windows, and MacOS are supported
* Be sure to download the most recent version
{% endstep %}

{% step %}
### Prepare for usage

* Rename the file you just downloaded to `gauntlet` for easy access
  * You can use your file manager to do this
* Mark the file as executable (only required on Linux and MacOS)
  * `chmod +x gauntlet`&#x20;
* Move to PATH for universal access (optional)&#x20;
  * There are plenty of articles online for how you can do this for your respective OS
{% endstep %}

{% step %}
### Verify Installation Works

* In the same folder as the `gauntlet` file, run:
  * Linux/MacOS: `./gauntlet test`
  * Windows:  `.\gauntlet.exe test`
* If you see `You've successfully installed Gauntlet!`, then you're all set!
* If you don't see that message, then join the [Discord server](https://discord.gg/eK3zJYrN58) and ask for help
{% endstep %}
{% endstepper %}
