Skip to content

OliveTin

Deploy OliveTin on Kubernetes using the official jamesread/olivetin container image. OliveTin provides a clean web interface for running predefined shell commands, making it easy to give safe access to common system actions.

Key Features

  • ConfigMap-Based Actions — define shell commands in YAML, mounted as a ConfigMap
  • Web UI — clean, responsive browser interface for triggering actions
  • Prometheus Metrics — optional metrics scraping with ServiceMonitor support
  • Customizable — action titles, icons, and confirmation prompts
  • Lightweight — minimal resource footprint with no external dependencies

Installation

HTTPS repository:

helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install olivetin helmforge/olivetin

OCI registry:

helm install olivetin oci://ghcr.io/helmforgedev/helm/olivetin

Basic Example

# values.yaml
config: |
  actions:
    - title: "Ping Google"
      shell: "ping -c 1 google.com"
    - title: "Show Disk Usage"
      shell: "df -h"

ingress:
  enabled: true
  ingressClassName: traefik
  hosts:
    - host: olivetin.example.com
      paths:
        - path: /
          pathType: Prefix

Key Values

KeyDefaultDescription
config(see below)OliveTin YAML configuration block
olivetin.port1337Application port
metrics.enabledfalseEnable Prometheus metrics
metrics.serviceMonitor.enabledfalseCreate ServiceMonitor for Prometheus Operator
persistence.enabledfalseEnable persistence for custom data
ingress.enabledfalseEnable ingress

More Information