Installing Apps

Deploy additional applications on your Obol Stack

The Obol Stack supports installing additional applications on top of your local Kubernetes cluster. Applications extend the functionality of your stack with monitoring, RPC proxies, and other services.

The application system is under active development. Currently, default applications are deployed automatically with the stack. The obol app command for installing additional applications is planned for a future release.

Default applications

When you run obol stack up, the following applications are automatically deployed:

Monitoring stack

A complete monitoring solution based on Prometheus and Grafana:

• Grafana - Dashboards and visualization

• Prometheus - Metrics collection and storage

• Pre-configured dashboards - Kubernetes and application metrics

Access Grafana at: http://grafana.localhost:8080

Grafana is configured with anonymous admin access for local development. No login required.

Access Prometheus at: http://prometheus.localhost:8080

Local path provisioner

Provides persistent storage for applications using local disk. All networks and applications use this storage class by default.

Application architecture

Applications in Obol Stack follow a self-registration pattern for monitoring:

• ServiceMonitors - Applications expose metrics that Prometheus discovers via the release: monitoring label.

• Grafana dashboards - Applications can provide dashboards via ConfigMaps with the grafana_dashboard: "1" label.

This means networks you install (Ethereum, Aztec, etc.) automatically appear in the monitoring stack.

Planned features

The following features are planned for future releases:

Application management commands

obol app list                    # List available apps
obol app install <app-name>      # Install an application
obol app edit <app-name>         # Edit application configuration
obol app sync <app-name>         # Deploy/update application
obol app delete <app-name>       # Remove application

Additional applications

• ERPC - Unified RPC proxy and load balancer for Ethereum endpoints

• Obol Frontend - Web-based management interface

Viewing application status

Check running applications:

# View default namespace resources
obol kubectl get all -n default

# View monitoring stack
obol kubectl get all -n monitoring

# View all Helm releases
obol helm list -A

Accessing services

Services are exposed via Traefik ingress on ports 8080 (HTTP) and 8443 (HTTPS).

Service	URL
Grafana	http://grafana.localhost:8080
Prometheus	http://prometheus.localhost:8080

The obol.stack hostname is added to /etc/hosts during installation, enabling local DNS resolution for stack services.