# Quickstart guide

## 1. Download software

The latest stable version of Gunbot is always available on Github.

{% content-ref url="/pages/-LdImDdhsf7bWzksUvIk" %}
[Download software](/wiki/setup-and-general-settings/installation/download.md)
{% endcontent-ref %}

## 2. Install & startup

The installation procedure is pretty straightforward, although there are slight differences between operating systems. The general steps are always the same:

1. Unpack the zip file to a new folder
2. On Mac and Linux: set executable permission for the program
3. Depending on your firewall: allow TCP traffic on the port used for the interface (default port: 5000)
4. Start executable file and visit the interface in your browser on: <http://localhost:5000>

#### Detailed steps per operating system:

{% content-ref url="/pages/-LdImDdiu4aaqLHiyDQg" %}
[Windows installation](/wiki/setup-and-general-settings/installation/windows.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LdImDdjpfRCAdw\_6nLj" %}
[macOS installation](/wiki/setup-and-general-settings/installation/macos.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LdImDdk6TcXLSRmNYjv" %}
[Linux installation](/wiki/setup-and-general-settings/installation/linux.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LdImDdloCWloaecR3fh" %}
[ARM installation](/wiki/setup-and-general-settings/installation/arm.md)
{% endcontent-ref %}

{% hint style="info" %}
On Mac systems, expect to need to explicitly allow running various libraries used by Gunbot due to Gatekeeper restrictions.
{% endhint %}

## 3. Enter license data and connect an exchange

Before you can start trading with the bot, the welcome wizard guides you through a few essential settings.

![](/files/-MOq4gO72O1uP4Lz1qyk)

When you first start the interface, it will show a window that guides you through the initial setup of:

* Entering the wallet address where you hold your Gunthy tokens
* Connecting one exchange for which you've registered an API key after your order. Make sure to use the same API key as you've registered.
* Enter the fee percentage for the exchange you're connecting. This is used for properly calculating the break even point of every single trade the bot makes. If you're unsure, look it up the right percentage in the support docs of your exchange. On Binance (spot) the default fee level is 0.1.

{% hint style="info" %}
Pick "other" if your registered exchange is not listed on the setup wizard.\
After saving, you can enter the exchange details on the profile page.
{% endhint %}

## 4. Add a trading pair and configure your first strategy

The easiest way to get started with strategies in Gunbot is using the [**Easy edit**](http://localhost:5000/easy-edit) wizard. This guides you through the steps of adding a trading pair and configuring a strategy to execute.

![](/files/-MOq6NbQzekq6ySFnLuJ)

To configure the strategy, you can pick any of the included presets or enter a new name to create your own strategy.

!["gain" is an easy strategy to learn.](/files/-MMRBpVoRvuEp3FHzBXf)

Review your settings, then save the settings and hit the start trading button to run the bot you've just configured.

![Save the settings and start trading to run the bot on the pair you've just configured](/files/-MMRCF3bVV1vqA4rtsWY)

If you see a screen like this after starting trading, you're up and running. If the strategy has targets that can be translated to a price, you'd see the relevant targets right on the chart.

!["Buy at" is where a gain strategy will buy](/files/-MMRDS7F95uqKpJTIpKk)

## 5. Ready to go. Keep reading to get the most out of your bot

Your bot should now be up and running.

However, this is really just the beginning. There are a lot of strategy options, you should learn at least about the ones that will affect your trading strategy (if you've picked one already).

If you read through at least the following pages, you should quickly get a much clearer idea about how Gunbot actually works and how you can make it work for you.

### General information

{% content-ref url="/pages/-LdImDe5aH1DsOUYIS3T" %}
[Trading logic](/wiki/how-to-work-with-gunbot/basic-workings/trading-logic.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MKdgtGXOCVJJEWAs\_H1" %}
[Pair processing](/wiki/how-to-work-with-gunbot/editing-strategies-and-pairs/trading-pairs/pair-processing.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LdImDeB8\_Ig\_\_ApjBZy" %}
[Strategies & pairs](/wiki/how-to-work-with-gunbot/editing-strategies-and-pairs.md)
{% endcontent-ref %}

### Essential info about strategies

{% content-ref url="/pages/-LdImDe6S0fQwIErfaJ9" %}
[Important settings](/wiki/how-to-work-with-gunbot/basic-workings/balance-settings.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LdImDeH-8oSAXBGku1g" %}
[About Gunbot strategies](/wiki/trading-strategy-options/about-gunbot-strategies.md)
{% endcontent-ref %}


---

# 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://gunthy.gitbook.io/wiki/setup-and-general-settings/installation/quickstart-guide.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.