Windows install

Yes, OliveTin is supported on Windows, too!

You can instal install OliveTin as a Windows service, follow the instructions to install OliveTin as a Windows service.

Download and run

  1. You can download the latest version of OliveTin here: OliveTin-windows-amd64.zip

  2. Unzip and run "OliveTin.exe"

Process log directory

On Windows, OliveTin writes its process logs (startup messages, configuration load, errors, and internal diagnostics) to a log file on disk. By default these files are stored under %ProgramData%\OliveTin\logs\ as OliveTin-service-<timestamp>.log.

This is separate from action execution logs (saveLogs), which persist command output from individual actions.

Portable or self-contained installs often keep OliveTin, its configuration, and its logs together in one folder. Without a custom path, process logs always go to %ProgramData%, even when you run OliveTin from another location.

Add a serviceLogs block to your config.yaml:

serviceLogs:
  directory: ./logs/service/

OliveTin creates the directory if it does not exist and writes a new timestamped log file there on each startup.

If serviceLogs.directory is omitted, OliveTin uses the default location: %ProgramData%\OliveTin\logs\.

Relative paths (for example ./logs/service/) are resolved from the directory containing OliveTin.exe. This keeps portable installs self-contained when you colocate logs with the application.

serviceLogs.directory is Windows only. If you set it on Linux, macOS, or in a container, OliveTin logs an error at startup and ignores the setting. On those platforms, use service logs troubleshooting for how to read process output (for example journalctl or container logs).

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.