Skip to main content

First-Time Gunbot Setup

This guide takes you from a new Gunbot download to a connected, registered installation.

What stays on your device

  • Gunbot on your device holds exchange credentials, runs strategies, and places trades.
  • Gunbot Live lets you configure, control, and monitor that bot from your browser.

Your trading core and exchange credentials remain on the device or server you control.

Have this ready

Have your Gunbot order number ready. During setup, you will also create or choose a license wallet and register the public API key for your first exchange.

Phase 1: Run Gunbot Locally​

1. Download and Start Gunbot​

Open the Gunbot download page and download the Full install for your operating system.

Extract the archive to a folder where Gunbot can keep its configuration and data. Start Gunbot using the instructions for your operating system:

Keep Gunbot running

Keep Gunbot running for the rest of the setup.

2. Create the Local Password​

On the device running Gunbot, open:

http://localhost:3001

Choose a password for the local Gunbot interface and select Save password. You will use this password when connecting the bot to Gunbot Live.

Set the initial password in the local Gunbot interface

Using a different GUI port?

If you changed config.GUI.port in config.js, replace 3001 with the configured port.

Phase 2: Connect to Gunbot Live​

3. Choose Gunbot Live​

Select Connect to Gunbot Live.

Choose Connect to Gunbot Live

Your trading setup stays local

This does not move the trading core or exchange credentials into the cloud. Gunbot continues to run on your device.

4. Make the Bot Reachable​

The connectivity check confirms that Gunbot Live can reach your bot. A failed first check is normal on a new installation.

Gunbot connectivity check and connection options

For most home networks, Tunnel Mode is the easiest option. It creates a secure public address without requiring router port forwarding.

Use a custom address only when you already have one

Use a custom address instead when you already have:

  • A public hostname with trusted HTTPS.
  • A public IP with port 3001 forwarded to this device.
  • Another tunnel URL that reaches the Gunbot interface.

When the check succeeds, select Connect to Gunbot Live. Gunbot opens Gunbot Live and prefills its connection details.

5. Sign In​

If asked, sign in to Gunbot Live using Google, GitHub, Telegram, Discord, your Gunthy wallet, or another available provider.

Gunbot Live sign-in screen

Signing in only authenticates your account

The provider only authenticates your account. It does not receive your exchange credentials, bot configuration, strategy files, or trading history.

Starting directly in Gunbot Live?

If you opened Gunbot Live directly instead of arriving from the connectivity check, choose First time running Gunbot.

Choose the first-time Gunbot setup

6. Connect the Running Bot​

The preparation screen summarizes the steps you just completed. Select Continue to connect.

Review the preparation checklist

Check the prefilled bot address, enter the local GUI password, and give the connection a recognizable name. Then select Connect to bot.

Connect the running Gunbot instance

Only if you use 2FA

Only enable 2FA if this Gunbot instance asks for a current 2FA code.

Phase 3: Register the License​

7. Verify Your Order​

Enter the order number from your Gunbot purchase and select Verify order.

Enter and verify the Gunbot order number

8. Create or Choose the License Wallet​

Every Gunbot license is linked to a wallet address. Enter an existing compatible wallet or let Gunbot Live generate one.

Keep the wallet backup private

The backup contains the private key. Never paste it into Gunbot, Gunbot Live, a support ticket, chat, or email. License verification only needs the public wallet address.

To generate a wallet:

  1. Select Generate new wallet.
  2. Select Generate wallet.
  3. Download the wallet backup.
  4. Store the backup somewhere safe and offline.
  5. Confirm that you saved it, then continue.

Generate and back up the license wallet

9. Register the First Exchange Key​

Choose your first exchange and enter its public API key. This registers the key with your license; it does not start trading.

Register the first exchange public API key

Keep the API secret available

Keep the API secret available. You will enter the remaining exchange credentials in Settings after registration.

Phase 4: Finish the Exchange Connection​

10. Complete the Exchange Connection​

After registration succeeds, select Complete exchange connection.

Successful Gunbot first-time setup

In Settings, add the remaining exchange credentials before creating trading pairs or starting the bot.

Your setup is now ready

  • Gunbot runs and trades on your own device or server.
  • Exchange credentials remain with that Gunbot instance.
  • Gunbot Live provides remote configuration, monitoring, and analysis.

Gunbot runs independently

If Gunbot Live is temporarily unavailable, that alone does not stop a bot that is already running. Trading logic continues inside your Gunbot instance.

Troubleshooting​

localhost:3001 does not open

Make sure Gunbot is still running. If you changed the GUI port, use the value of config.GUI.port from config.js.

Gunbot Live cannot reach the bot

Try Tunnel Mode first. For direct access, check the public address, port forwarding, firewall rules, and trusted HTTPS certificate.

The GUI password is rejected

Use the password created in the local Gunbot interface. The password belongs to this specific Gunbot installation.

The tunnel stops working

Keep Gunbot and its tunnel running. If the tunnel address changes, update the saved connection in Gunbot Live.