# OliveTin/OliveTin

OliveTin gives safe and simple access to predefined shell commands from a web interface.

Repository: https://github.com/OliveTin/OliveTin
Canonical: https://ross.abutalabs.com/products/olivetin
Homepage: https://olivetin.app
Language: Go
License: AGPL-3.0
License Family: copyleft
Topics: linux, homeautomation, selfhosted, sysadmin, service, api, container, maturity-prod
Last push: 2026-08-26T20:03:36+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 85, longevity 100
- inputs: {"age_days": 1944, "days_push": 7, "days_rel": 22, "gap_med": 4.0, "n_releases_24m": 81}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3772, forks 136 (observed 2026-08-28T04:08:18.159443+00:00)

## What it is
OliveTin is a lightweight, self-hosted web application written in Go that exposes predefined shell commands as clickable buttons in a simple web interface. It is configured via YAML, supports argument forms, ACL-based access control, execution logging, and runs on tiny ARM devices up to full servers.

## Use cases
- give my family a web button to restart plex
- let junior admins run a backup script with dropdown arguments
- run long server commands from my phone
- expose wake-on-lan on a wall tablet
- temporarily enable SSH access with a timeout
- give AI agents a limited set of approved shell actions
- turn complex docker commands into one-click buttons

## When to choose
- you want a dead-simple YAML-configured UI for predefined commands
- you need safe, restricted command access for non-technical users
- you want a lightweight self-hosted tool that runs on ARM/RISC devices
- you need audit logs of who ran what command

## When to avoid
- you need a full-featured admin panel or general-purpose remote shell
- you need arbitrary ad-hoc command execution rather than predefined actions
- you require enterprise-grade security hardening beyond ACLs and basic auth options

## Facets
- artifact type: application
- maturity: stable
- function: http-server, web-framework, configuration-management, workflow-automation, auth, authorization, logging
- domain: self-hosted, web-development, developer-tools
- platform: windows, self-hosted, go, cross-platform
- tags: shell-commands, web-ui, yaml-config, home-automation, sysadmin, buttons, rbac, webhook, lightweight, automation, devops, linux, macos, docker, web-server

## Member repositories
- OliveTin/OliveTin (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:18.159443+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:27:52.214087+00:00, confidence not recorded.
  - readme: https://github.com/OliveTin/OliveTin (fetched 2026-08-28T04:08:18.159443+00:00, sha e17cddbd73ab)
  - homepage: https://olivetin.app (fetched 2026-08-29T09:22:43.504530+00:00, sha 6c3a2d04584a)
  - site_page: https://docs.olivetin.app (fetched 2026-08-29T09:22:43.507341+00:00, sha 90ccffac6f3f)
  - site_page: https://docs.olivetin.app/install/intro.html (fetched 2026-08-29T09:22:43.509213+00:00, sha 80229e5a78b9)
  - site_page: https://docs.olivetin.app/action_buttons/create_your_first.html (fetched 2026-08-29T09:22:43.510817+00:00, sha c304f145a985)
  - site_page: https://docs.olivetin.app/security/acl.html (fetched 2026-08-29T09:22:43.512332+00:00, sha 4e2a5ec43456)
  - site_page: https://docs.olivetin.app/logs/intro.html (fetched 2026-08-29T09:22:43.514038+00:00, sha fa26a54de794)
  - site_page: https://docs.olivetin.app/args/intro.html (fetched 2026-08-29T09:22:43.515643+00:00, sha c244b49e8791)
  - site_page: https://docs.olivetin.app/action_execution/shellvsexec.html (fetched 2026-08-29T09:22:43.517401+00:00, sha b56b7c0928d0)
  - site_page: https://docs.olivetin.app/security/concepts.html (fetched 2026-08-29T09:22:43.519048+00:00, sha f89b807c92b6)
- Data as of 2026-08-30T08:39:29.467469+00:00.