Sen descrición

jamesread db4ceabe5d Updated old examples from readme		%!s(int64=5) %!d(string=hai) anos
.github	0e06d22633 Create PULL_REQUEST_TEMPLATE.md	%!s(int64=5) %!d(string=hai) anos
cmd	7dcc62ad1d #10 - Early config reload support, added benefit of cleaning up ActionButton.js early state code	%!s(int64=5) %!d(string=hai) anos
internal	ef5e71fa94 Additional error check	%!s(int64=5) %!d(string=hai) anos
media	8802daafdf retook desktop screenshot, added dark	%!s(int64=5) %!d(string=hai) anos
proto	0a222532ae Moved google proto annotations into repo	%!s(int64=5) %!d(string=hai) anos
var	600ef4405d Added warning for individualPorts config.	%!s(int64=5) %!d(string=hai) anos
webui	46829925fe Merge branch 'main' of ssh://github.com/OliveTin/OliveTin	%!s(int64=5) %!d(string=hai) anos
.dockerignore	286fa43e95 Less junk in the docker image	%!s(int64=5) %!d(string=hai) anos
.gitignore	d91fddad84 dist contains the releases, ignore.	%!s(int64=5) %!d(string=hai) anos
.goreleaser.yml	a4185e6702 trying to get ARM images working	%!s(int64=5) %!d(string=hai) anos
CODE_OF_CONDUCT.md	35562e5667 Create CODE_OF_CONDUCT.md	%!s(int64=5) %!d(string=hai) anos
CONTRIBUTING.adoc	395691a8ef Point to the new PULL_REQUEST_TEMPLATE	%!s(int64=5) %!d(string=hai) anos
Dockerfile	e18809099a fix Dockerfile RUN and USER	%!s(int64=5) %!d(string=hai) anos
LICENSE	f21b38d7a6 Create LICENSE	%!s(int64=5) %!d(string=hai) anos
Makefile	a4def7571c Update check cleanup, gofmt and gocyclo = 3	%!s(int64=5) %!d(string=hai) anos
OliveTin.proto	5d01183198 Buttons are refreshed every 3s	%!s(int64=5) %!d(string=hai) anos
OliveTin.service	0acf2cbdea /usr/local/bin as we are not building distro packages	%!s(int64=5) %!d(string=hai) anos
README.md	db4ceabe5d Updated old examples from readme	%!s(int64=5) %!d(string=hai) anos
SECURITY.md	d19edc16c8 Create SECURITY.md	%!s(int64=5) %!d(string=hai) anos
go.mod	7dcc62ad1d #10 - Early config reload support, added benefit of cleaning up ActionButton.js early state code	%!s(int64=5) %!d(string=hai) anos
tools.go	dc76ca9a38 tools.go, not sure how this works though!	%!s(int64=5) %!d(string=hai) anos

OliveTin

OliveTin is a web interface for running Linux shell commands.

Some example use cases;

Give controlled access to run shell commands to less technical folks who cannot be trusted with SSH. I use this so my family can podman restart plex without asking me, and without giving them shell access!
Great for home automation tablets stuck on walls around your house - I use this to turn Hue lights on and off for example.
Sometimes SSH access isn't possible to a server, or you are feeling too lazy to type a long command you run regularly! I use this to send Wake on Lan commands to servers around my house.

Join the community on Discord.

YouTube video demo (6 mins)

Features

Responsive, touch-friendly UI - great for tablets and mobile
Super simple config in YAML - because if it's not YAML now-a-days, it's not "cloud native" :-)
Dark mode - for those of you that roll that way.
Accessible - passes all the accessibility checks in Firefox, and issues with accessibility are taken seriously.
Container - available for quickly testing and getting it up and running, great for the selfhosted community.
Integrate with anything - OliveTin just runs Linux shell commands, so theoretially you could integrate with a bunch of stuff just by using curl, ping, etc. However, writing your own shell scripts is a great way to extend OliveTin.
Lightweight on resources - uses only a few MB of RAM and barely any CPU. Written in Go, with a web interface written as a modern, responsive, Single Page App that uses the REST/gRPC API.
Good amount of unit tests and style checks - helps potential contributors be consistent, and helps with maintainability.

Screenshots

Desktop web browser;

Desktop web browser (dark mode);

Mobile screen size (responsive layout);

Documentation

All documentation can be found at http://docs.olivetin.app . This includes installation and usage guide, etc.

Quickstart reference for `config.yaml`

This is a quick example of config.yaml - but again, lots of documentation for how to write your config.yaml can be found at the documentation site.

Put this config.yaml in /etc/OliveTin/ if you're running a standard service, or mount it at /config if running in a container.

# Listen on all addresses available, port 1337
listenAddressSingleHTTPFrontend: 0.0.0.0:1337 

# Choose from INFO (default), WARN and DEBUG
logLevel: "INFO"

# Actions (buttons) to show up on the WebUI:
actions: 
  # Docs: https://docs.olivetin.app/action-container-control.html 
- title: Restart Plex
  icon: smile
  shell: docker restart plex
  
  # This will send 1 ping 
  # Docs: https://docs.olivetin.app/action-ping.html
- title: Ping Google.com
  shell: ping google.com -c 1
  
  # Restart lightdm on host "overseer"
  # Docs: https://docs.olivetin.app/action-ssh.html
- title: restart lightdm
  icon: poop
  shell: ssh root@overseer 'service lightdm restart'

A full example config can be found at in this repository - config.yaml.

README.md