.tar.gz Install (manual)

This is an option for an advanced setup, for users who cannot user the .deb or .rpm packages.

Manual setup (.tar.gz)

A .tar.gz file is provided for people who are using other Linux distributions or want to set things up manually.

  1. Copy the OliveTin binary to /usr/local/bin/OliveTin

  2. Copy the webui directory contents to /var/www/olivetin/ (eg, /var/www/olivetin/index.html)

  3. Copy the OliveTin.service file to /etc/systemd/system/

  4. Create a config.yaml in /etc/OliveTin using the example provided above to get you started.

Post installation

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

Create the following basic config file at /etc/OliveTin/config.yaml with the following contents;

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

Now that you have a configuration file, and OliveTin is installed, start it;

Start the service (only needed once)
user@host: systemctl enable --now OliveTin

If you are running a firewall on your server, like firewalld, you will need to open port 1337;

user@host: firewall-cmd --add-port 1337/tcp --permanent
user@host: firewall-cmd --reload

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 can jump to the configuration section as the next step.

Troubleshooting systemd installations

If you are having problems, you can check if OliveTin is running like this;

user@host: systemctl status OliveTin

If the service has failed, scroll through the logs;

user@host: journalctl -eu OliveTin

If you cannot understand the logs, or otherwise need help, see the Where to find help page.