Generic .deb based Linux
Running OliveTin as a systemd service on a Linux machine means it can use any program installed on your machine (you don’t have to add programs to a container). This is generally easier to use than a container, but containers can work just fine too with a bit more effort.
There are .deb packages published for OliveTin on each release page. If you distribution is not linked in this installation guide, and you use a .deb based Linux distribution, this package should work.
You can install these packages for .deb like this;
user@host: wget https://github.com/OliveTin/OliveTin/releases/latest/download/OliveTin_linux_amd64.deb
user@host: dpkg -i OliveTin_linux_amd64.deb
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;
config.yaml
file.actions:
- title: "Hello world!"
shell: echo 'Hello World!'
Now that you have a configuration file, and OliveTin is installed, start it;
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 are good to go! Here are some helpful next steps;
-
configuration section for a list of all configuration options.
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 [support] page.