Skip to main content

Getting Started

This guide walks you through deploying your first application using Hiroba's Helm chart templates.

Prerequisites​

  • A running Kubernetes cluster (k3s, kind, microk8s, or any distribution)
  • Helm v3.x installed
  • kubectl configured for your cluster
New to Kubernetes?

For homelab setups, k3s is a great starting point — it runs on a single node with minimal resources and includes an Ingress controller and load balancer out of the box.

Deploy from the Template​

  1. Clone the repo and copy the app skeleton:
git clone https://github.com/7KGroup/hiroba.git
cp -r hiroba/templates/app-template/skeleton ./my-app
cd my-app

  1. Replace all ${{ values.* }} placeholders with your actual values (app name, image, port, etc.)

  2. Deploy the base application:

helm install my-app ./helm/base
  1. Optionally deploy platform dependencies (requires the relevant operators on your cluster):
helm install my-app-platform ./helm/platform

Verifying Your Deployment​

kubectl get pods -l app.kubernetes.io/name=my-app
kubectl get svc my-app

Requesting a New Chart​

Want Hiroba to package an app we don't cover yet? Open a Chart Request issue on GitHub. A 7KGroup maintainer will review the request and scaffold a new app repository for the community.

Next Steps​