Skip to main content

macOS installation

Instructions to install Gunbot on a macOS machine.


  1. Unpack the release .zip file to a new folder.
  2. Open the folder, and hold the control key when clicking on the gunthy-macos application. This bypasses Gatekeeper restrictions (see tips below)
  3. Open localhost:5001 in a browser on the same system to access the Gunbot GUI. Modern browsers recommended, preferably Chrome or Firefox.
  4. The interface will prompt you to create a password, and configure the exchange connection.
Tips for common problems

System security settings may show that the gunthy-macos file is damaged or dangerous.

  • The easiest way to bypass Gatekeeper is by using the method described in the bottom of this article: this method
  • Another way to disable the OS restrictions on the Gunbot folder is using this command in a terminal window: xattr -d -r <foldername>

To run on an M1 processor, it can be needed to start a Rosetta terminal (see step 1 here) and use that terminal to launch Gunbot.


Depending on your systems settings, you may need to add a firewall rule to allow for incoming traffic on TCP port 5000.

Security notice

Gunbot is intended to run on your local system. Making the Gunbot GUI available from outside networks is inherently risky, only do so on your own responsibility.

Considerable efforts went into securing the GUI, but please understand that achieving 100% security is not realistic.

Alternate installation steps#

The following steps use the built in Terminal program to do a few one time tasks before running Gunbot.

1. Move the downloaded zip file to a folder where you want to unpack it#

2. Unpack the file#

In a terminal window, go to the folder where the .zip file is with the cd command, then unpack the zip

After you've done this, type cd macos to enter the actual program folder

3. Remove program restrictions (to make sure macos allows running it)#

Type xattr -d -r <foldername> to remove gatekeeper restrictions. Instead of <foldername>, use the full path to the folder where you have unpacked Gunbot.

4. Make sure the gunthy-macos file is executable#

Type chmod +x gunthy-macos to make sure it can be ran as a program.

5. Start the bot#

Type ./gunthy-macos to start running the software.

You can now access it in your browser using this link: http://localhost:5000