OliveTin

OliveTin is a self-hosted web application that exposes predefined shell commands through a responsive Single Page UI and an API. It uses a simple YAML configuration to define actions, dashboards and entities so administrators can make complex or dangerous commands safe and repeatable.

Key Features

• YAML-based configuration-as-code for actions, entities and dashboards, with live-reloadable options
• Responsive, touch-friendly Single Page App UI (light/dark modes) designed for tablets and mobile
• Action system: parameterised commands, timeouts, scheduled (cron) executions and execution logs
• Security model with multiple authentication options (local users, OAuth2, JWT, trusted headers) and ACL-based authorization per-action
• Multiple integration points: REST API / webhook endpoints and URL-based triggers for automation and streamdeck/QR integrations
• Container images, packages and Helm chart available for easy deployment; small resource footprint (Go backend)
• Accessibility-focused frontend and configurable UI theming and custom JS support

Use Cases

• Provide non-technical users (family, junior admins) one-click buttons to restart services or run maintenance scripts
• Trigger complex or long-running server operations from mobile devices or dashboards without giving shell access
• Integrate server commands into automation flows via webhooks, API calls or scheduled tasks (cron)

Limitations and Considerations

• Actions and dashboards are primarily defined in YAML configuration files; adding or editing actions requires editing config files (configuration-as-code), which may be less convenient for non-technical administrators
• Because OliveTin executes arbitrary shell commands, correct security configuration is essential; misconfigured authentication/ACLs can expose powerful operations
• Accounting/auditing for action executions is provided via logs but the documentation notes this area is less mature and may require additional operational procedures

OliveTin is intended for administrators who want a simple, auditable way to expose repeatable server operations without granting interactive shell access. It emphasizes safety, minimal resource usage and flexible integration via API and configuration.