macOS Desktop

OliveTin runs natively on macOS, on both Apple Silicon (M-series) and Intel Macs. It is a single, self-contained binary - there is no installer and no dependencies to set up.

If you want OliveTin to run in the background and start automatically, follow the install OliveTin as a launchd service instructions instead.

Download

macOS builds are published on the releases page. Choose the archive that matches your Mac’s processor:

Your Mac Archive

Apple Silicon (M1/M2/M3/M4)

OliveTin-darwin-arm64.tar.gz

Intel

OliveTin-darwin-amd64.tar.gz

Not sure which you have? Run uname -m in Terminal - arm64 means Apple Silicon, x86_64 means Intel.

If you run the wrong architecture, macOS reports Bad CPU type in executable. Download the other archive if you see this.

Extract

Start a terminal, then extract the archive and change into the directory (replace arm64 with amd64 on Intel):

tar -xzf OliveTin-darwin-arm64.tar.gz
cd OliveTin-darwin-arm64

Remove the Gatekeeper quarantine

The binary is downloaded from the internet and is not notarized by Apple, so on first run Gatekeeper blocks it with a message like "OliveTin can’t be opened because Apple cannot check it for malicious software."

Clear the quarantine attribute so it will run:

xattr -dr com.apple.quarantine ./OliveTin
Alternatively, the first time only, right-click the binary in Finder and choose Open, or approve it under System Settings → Privacy & Security.

Post installation

You will need to write a basic configuration file before OliveTin will startup.

Edit the basic config file at config.yaml with the following contents;

The most simple config.yaml file.
actions:
  - title: "Hello world!"
    shell: echo 'Hello World!'

Start OliveTin, preferably via a terminal. On Unix based systems (eg MacOS, BSD, Linux, etc) you can just run ./OliveTin. On Windows you would run OliveTin.exe in windows terminal.

You should be able to browse to http://yourserver:1337 (or similar) to get to the web interface.

If you see the OliveTin page popup in your browser, you are good to go! Here are some helpful next steps;

Troubleshooting installations

If you are having problems, OliveTin will log it’s status on startup. Check the log messages in the terminal.

For tips on capturing and sharing that output, see Service logs (troubleshooting).

If you cannot understand the logs, or otherwise need help, see the support page.