Skip to main content

Installing Gunbot on MacOS


Setting up Gunbot on a MacOS system is a straightforward process that involves downloading the software, unzipping the file, modifying system permissions, and configuring the application. This guide provides a step-by-step walkthrough to help you get Gunbot up and running on your MacOS device.

Step 1: Downloading Gunbot

First, navigate to the official Gunbot repository to download the necessary files for MacOS:

Step 2: Extracting the File

After downloading, locate the file in your Downloads folder and extract it:

  • Double-click the zip file to unzip it.
  • A new folder named Gunbot will be created.

Step 3: Setting Up in Terminal

With the files extracted, the next step involves using the MacOS Terminal to set permissions and prepare Gunbot for use.

Accessing the Terminal

  • Open Terminal (Finder > Applications > Utilities > Terminal).
  • Alternatively, use Spotlight search (Command + Spacebar) and type "Terminal".

Remember to keep the Terminal open during these steps for smooth setup.

  • In Terminal, type cd (with a space after cd) but do not press enter yet.
  • Drag and drop the Gunbot folder into Terminal to autocomplete the path.
  • Press enter.

Changing File Permissions

  • Run the following command in Terminal to grant execution permissions to Gunbot:
    chmod +x gunthy-macos
  • Press enter.

Whitelisting Gunbot Folder

  • Whitelist the Gunbot folder in Apple Security Settings with this command (replace the placeholder with your Gunbot folder path):
    xattr -r -d /path/To/Your/Gunbotfolder
  • Terminal may show errors, which can typically be ignored if the path is correct.

Step 4: Launching Gunbot

Now, you're ready to start Gunbot:

  • Enter the following command in Terminal:
  • Open a web browser and go to http://localhost:3000 to access Gunbot.

Addressing Port Conflicts

If you encounter an EADRRINUSE error due to port conflicts, follow these steps:

  • Navigate to the Gunbot folder and find config.js.
  • Open it with a text editor (like TextEdit).
  • Search for "port": 3000, and change it to "port": 5001,.
  • Save the changes and restart Gunbot.
  • Access Gunbot at http://localhost:5001.


You've successfully installed Gunbot on MacOS. By following these steps, you can now begin automating your trading strategies with Gunbot on your MacOS device. For further assistance or troubleshooting, consult the Gunbot support resources or community forums.