helm-charts

Osmosis Fullnode Helm Chart

A Helm chart for deploying Osmosis blockchain fullnode with monitoring and sentinel capabilities.

Overview

This chart deploys:

Osmosis blockchain node with Cosmovisor
Droid monitoring service
Sentinel CronJob for automatic cleanup
Multiple service endpoints (RPC, LCD, gRPC, P2P, Metrics)

Installation

Add Helm Repository

helm repo add osmosis-charts https://osmosis-labs.github.io/helm-charts
helm repo update

Install Chart

# Install with default values
helm install my-osmosis-node osmosis-charts/osmosis-fullnode

# Install with custom values
helm install my-osmosis-node osmosis-charts/osmosis-fullnode -f values.yaml

Configuration

Basic Configuration

# Image versions
images:
  osmosis:
    tag: "29.0.2"
  droid:
    tag: "0.0.4"

# Resource limits
containers:
  osmosis:
    resources:
      limits:
        memory: "32Gi"
        cpu: "4"
      requests:
        memory: "16Gi"
        cpu: "2"

# Storage
storage:
  hostPath: "/osmosis-data"

# Services
services:
  rpc:
    enabled: true
    type: LoadBalancer
    port: 26657
  lcd:
    enabled: true
    type: ClusterIP
    port: 1317

Advanced Configuration

Multiple Nodes

# Deploy multiple nodes with different suffixes
helm install osmosis-node-0 osmosis-charts/osmosis-fullnode --set global.nameSuffix="-node-0"
helm install osmosis-node-1 osmosis-charts/osmosis-fullnode --set global.nameSuffix="-node-1"

Monitoring

monitoring:
  enabled: true
  datadog:
    enabled: true

Sentinel Configuration

sentinel:
  enabled: true
  schedule: "0 */6 * * *"
  config:
    maxDirSizeGb: 200
    monitorPath: "/osmosis/.osmosisd"

Parameters

Global Parameters

Name	Description	Default
`global.nameSuffix`	Suffix for resource names	`""`
`namespace`	Kubernetes namespace	`"fullnodes"`

Image Parameters

Name	Description	Default
`images.osmosis.repository`	Osmosis image repository	`"osmolabs/osmosis-cosmovisor"`
`images.osmosis.tag`	Osmosis image tag	`"29.0.2"`
`images.droid.repository`	Droid image repository	`"osmolabs/droid"`
`images.droid.tag`	Droid image tag	`"0.0.4"`

Resource Parameters

Name	Description	Default
`containers.osmosis.resources.limits.memory`	Memory limit	`"63Gi"`
`containers.osmosis.resources.limits.cpu`	CPU limit	`"8"`
`containers.osmosis.resources.requests.memory`	Memory request	`"24Gi"`
`containers.osmosis.resources.requests.cpu`	CPU request	`"2"`

Storage Parameters

Name	Description	Default
`storage.hostPath`	Host path for data	`"/tmp/osmosis-data"`

Service Parameters

Name	Description	Default
`services.rpc.enabled`	Enable RPC service	`true`
`services.rpc.port`	RPC service port	`26657`
`services.lcd.enabled`	Enable LCD service	`true`
`services.lcd.port`	LCD service port	`1317`

Troubleshooting

Common Issues

Pod stuck in Pending: Check node resources and tolerations
Sentinel not working: Verify RBAC permissions and pod affinity
Service not accessible: Check service type and port configuration

Useful Commands

# Check pod status
kubectl get pods -n fullnodes -l app.kubernetes.io/name=osmosis-fullnode

# Check logs
kubectl logs -n fullnodes -l app.kubernetes.io/name=osmosis-fullnode -c osmosis

# Port forward for local access
kubectl port-forward -n fullnodes svc/my-osmosis-node-rpc 26657:26657

Upgrading

helm upgrade my-osmosis-node osmosis-charts/osmosis-fullnode

Uninstalling

helm uninstall my-osmosis-node