helm-charts

Osmosis Helm Charts

Public repository for Osmosis blockchain infrastructure Helm charts.

Available Charts

Chart Description Version App Version
osmosis-fullnode Osmosis blockchain fullnode with monitoring 0.1.0 29.0.2

Quick Start

Add Helm Repository

helm repo add osmosis-charts [repo_url]
helm repo update

Install a Chart

# Install osmosis-fullnode
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

# Install specific version
helm install my-osmosis-node osmosis-charts/osmosis-fullnode --version 0.1.0

Development

Prerequisites

Adding New Charts

  1. Create new chart directory: 
    mkdir -p charts/my-new-chart
helm create charts/my-new-chart

  2. Follow the Chart Guidelines

  3. Test your chart: 
    # Lint
helm lint charts/my-new-chart/
   
# Template
helm template charts/my-new-chart/
   
# Install locally
helm install test-release charts/my-new-chart/ --dry-run

Testing Charts

# Lint all charts
./scripts/lint-charts.sh

# Test all charts
./scripts/test-charts.sh

Release Process

Automated Releases

Charts are automatically released when you push a tag:

# Release osmosis-fullnode v1.0.0
git tag chart-osmosis-fullnode-v1.0.0
git push origin chart-osmosis-fullnode-v1.0.0

Manual Testing

Use the GitHub Actions workflow dispatch to test releases:

  1. Go to Actions → Release Helm Chart
  2. Click “Run workflow”
  3. Fill in:
    • Chart name: osmosis-fullnode
    • Version: 1.0.0-test
    • Dry run: true (for testing)

Chart Guidelines

Naming Conventions

Version Management

Contributing

  1. Fork the repository
  2. Create feature branch (git checkout -b feature/new-chart)
  3. Add/modify charts
  4. Test thoroughly
  5. Submit pull request

Pull Request Checklist

Support