Skip to main content

Installing Gunbot on MacOS

Introduction​

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:

MacOS Installation Step 1: Download and extract Gunbot

Step 2: Extracting the File​

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

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

MacOS Installation Step 2: Locate the extracted files MacOS Installation Step 3: View extracted contents MacOS Installation Step 4: Locate the Gunbot executable

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".
info

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.

MacOS Installation Step 5: Terminal commands demonstration for starting Gunbot

Changing File Permissions​

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

MacOS Installation Step 6: Using PM2 to manage Gunbot process

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 com.apple.quarantine /path/To/Your/Gunbotfolder
  • Terminal may show errors, which can typically be ignored if the path is correct.

MacOS Installation Step 7: Monitoring Gunbot with PM2

Step 4: Launching Gunbot​

Now, you're ready to start Gunbot:

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

MacOS Installation Step 8: Security warning for unsigned application

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.

    MacOS Installation Step 9: System preferences security settings

  • Open it with a text editor (like TextEdit).

    MacOS Installation Step 10: Allow app execution

  • Search for "port": 3001, and change it to "port": 3002,.

    MacOS Installation Step 11: Confirm app execution

    MacOS Installation Step 12: Successful Gunbot startup

  • Save the changes and restart Gunbot.

  • Access Gunbot at http://localhost:3002.

Conclusion​

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.