beszel-ipv6/supplemental/helm/beszel-hub

Beszel Hub Helm Chart

A Kubernetes Helm chart for deploying Beszel Hub - a monitoring and alerting solution for systems, containers, and services.

Overview

This Helm chart simplifies the deployment of Beszel Hub in Kubernetes environments. Beszel Hub is a centralized monitoring hub that collects and aggregates system metrics from multiple agents deployed across your infrastructure.

Prerequisites

• Kubernetes 1.19+
• Helm 3.0+
• At least 500Mi of persistent storage (configurable)

Quick Start

1. Add the Repository

helm repo add beszel https://henrygd.github.io/beszel
helm repo update

2. Install the Chart

helm install beszel-hub ./beszel-hub

Or with a custom values file:

helm install beszel-hub ./beszel-hub -f custom-values.yaml

3. Access Beszel Hub

By default, Beszel Hub is accessible at http://beszel-hub:8090 within the cluster.

# Port forward to access locally
kubectl port-forward svc/beszel-hub 8090:8090

Then visit: http://localhost:8090

Configuration

Basic Configuration

Key configuration options in values.yaml:

Parameter	Default	Description
replicaCount	1	Number of Beszel Hub replicas
image.repository	henrygd/beszel	Container image repository
image.tag	Chart AppVersion (0.17.0)	Container image tag
image.pullPolicy	IfNotPresent	Image pull policy
service.port	8090	Service port
persistentVolumeClaim.enabled	true	Enable persistent volume
persistentVolumeClaim.size	500Mi	PVC size

Installation with Custom Values

helm install beszel-hub ./beszel-hub \
  --set replicaCount=2 \
  --set persistentVolumeClaim.size=1Gi \
  --set service.type=LoadBalancer

Or create a custom values file:

# custom-values.yaml
replicaCount: 2
service:
  type: LoadBalancer
persistentVolumeClaim:
  size: 1Gi

Then install:

helm install beszel-hub ./beszel-hub -f custom-values.yaml

Advanced Configuration

Ingress Configuration

Enable and configure Ingress for external access:

ingress:
  enabled: true
  className: nginx  # or your ingress class
  annotations:
    cert-manager.io/cluster-issuer: "letsencrypt-prod"
  hosts:
    - host: beszel.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: beszel-tls
      hosts:
        - beszel.example.com

Persistent Volume Configuration

To use an existing PersistentVolumeClaim:

persistentVolumeClaim:
  enabled: true
  existingClaim: "my-existing-pvc"

Or to use a specific storage class:

persistentVolumeClaim:
  enabled: true
  storageClass: "fast-ssd"
  size: 1Gi

Resource Limits

Set CPU and memory limits:

resources:
  limits:
    cpu: 500m
    memory: 512Mi
  requests:
    cpu: 250m
    memory: 256Mi

Autoscaling

Enable Horizontal Pod Autoscaler:

autoscaling:
  enabled: true
  minReplicas: 2
  maxReplicas: 10
  targetCPUUtilizationPercentage: 80

Node Selection

Schedule pods on specific nodes:

nodeSelector:
  node-type: monitoring

tolerations:
  - key: "monitoring"
    operator: "Equal"
    value: "true"
    effect: "NoSchedule"

Deployment Examples

Production Setup

replicaCount: 3
image:
  tag: "0.17.0"
service:
  type: LoadBalancer
ingress:
  enabled: true
  className: nginx
  hosts:
    - host: beszel.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: beszel-tls
      hosts:
        - beszel.example.com
persistentVolumeClaim:
  enabled: true
  storageClass: "fast-ssd"
  size: 2Gi
resources:
  limits:
    cpu: 1000m
    memory: 1Gi
  requests:
    cpu: 500m
    memory: 512Mi
autoscaling:
  enabled: true
  minReplicas: 3
  maxReplicas: 10
  targetCPUUtilizationPercentage: 75

Development/Test Setup

replicaCount: 1
service:
  type: ClusterIP
persistentVolumeClaim:
  enabled: true
  size: 500Mi
resources:
  limits:
    cpu: 200m
    memory: 256Mi
  requests:
    cpu: 100m
    memory: 128Mi

Managing Beszel Hub

Upgrade

helm upgrade beszel-hub ./beszel-hub

Check Status

# Get deployment status
kubectl get deployment beszel-hub
kubectl get pods -l app.kubernetes.io/name=beszel

# Get service info
kubectl get svc beszel-hub

View Logs

kubectl logs -l app.kubernetes.io/name=beszel -f

Access Pod Shell

kubectl exec -it <pod-name> -- sh

Uninstall

helm uninstall beszel-hub

Connecting Beszel Agents

After deploying Beszel Hub, you can connect Beszel agents running on:

• Kubernetes nodes
• VM instances
• Bare metal servers
• Docker containers

Agents communicate with the Hub on port 8090. Configure the agent with the Hub's address:

HUB_URL=http://beszel-hub.default.svc.cluster.local:8090

Or for external access, use the LoadBalancer IP/DNS or Ingress hostname.

Troubleshooting

Pod won't start

# Check pod status and events
kubectl describe pod <pod-name>
kubectl logs <pod-name>

Persistent volume issues

# Check PVC status
kubectl get pvc
kubectl describe pvc beszel-hub

Connection issues with agents

• Verify the service is accessible: kubectl get svc beszel-hub
• Check network policies aren't blocking traffic
• Ensure agents can resolve the Hub's DNS name
• Verify port 8090 is open on the service

Storage full

Increase PVC size:

# Update the PVC size in values
helm upgrade beszel-hub ./charts/beszel-hub \
  --set persistentVolumeClaim.size=2Gi

Security Considerations

• Use network policies to restrict traffic to Beszel Hub
• Enable RBAC and pod security policies
• Use TLS/HTTPS via Ingress with cert-manager
• Regularly update the image to the latest version
• Consider running with read-only filesystem
• Use private container registries if applicable

Persistence

By default, Beszel Hub uses a PersistentVolumeClaim for data storage. Ensure your Kubernetes cluster has enough storage capacity and a default storage class configured.

Support and Documentation

• Project Homepage: https://www.beszel.dev/
• GitHub Repository: https://github.com/henrygd/beszel
• Chart Repository: https://github.com/henrygd/beszel-kubernetes

Chart Information

• Chart Version: 0.1.0
• App Version: 0.17.0
• Kubernetes Version: 1.19+
• Maintainer: cloudwithdan (nikoloskid@pm.me)

License

Please refer to the main Beszel project repository for license information.