A curated collection of Helm charts for Kubernetes deployments, including custom charts and an enhanced distribution of Alfresco Helm Charts.

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

helm search repo microboxlabs

helm install my-release microboxlabs/<chart-name>

This repository includes an enhanced distribution of Alfresco Helm Charts with additional configuration options:

Full documentation is available at: https://microboxlabs.github.io/helm-charts/

The documentation includes:

• Installation guides
• Chart configuration reference
• Architecture guides
• Best practices

• Helm v3.x
• Node.js v20+ (for documentation site)

# Clone the repository
git clone https://github.com/microboxlabs/helm-charts.git
cd helm-charts

# Lint charts
helm lint charts/modulariot
helm lint charts/miot-app
helm lint charts/miot-docs
helm lint charts/miot-web-site
helm lint charts/miot-calendar
helm lint charts/quarkus-sse

# Template a chart locally
helm template my-release charts/modulariot
helm template my-release charts/miot-app

cd docs
npm install
npm run dev      # Development server at http://localhost:3002/helm-charts/
npm run preview  # Build and preview static site

helm-charts/
├── .github/workflows/     # CI/CD workflows
│   ├── ci.yaml           # Chart linting and releases
│   ├── docs.yml          # Documentation deployment
│   └── sync-*.yaml       # Alfresco upstream sync
├── charts/
│   ├── alfresco/         # Alfresco charts (git subtree)
│   ├── modulariot/       # ModularIoT umbrella chart
│   ├── miot-app/         # ModularIoT main application
│   ├── miot-docs/        # ModularIoT documentation
│   ├── miot-web-site/    # ModularIoT website
│   ├── miot-calendar/    # MIOT Calendar microservice
│   └── quarkus-sse/      # Quarkus SSE application
└── docs/                 # Nextra documentation site

This repository maintains a fork of Alfresco Helm Charts using git subtree. Changes from the upstream repository are automatically detected weekly and proposed via Pull Request.

To manually sync with upstream:

# Add upstream remote (if not already added)
git remote add alfresco-upstream https://github.com/Alfresco/alfresco-helm-charts.git

# Fetch and merge upstream changes
git fetch alfresco-upstream main --no-tags
git subtree pull --prefix=charts/alfresco alfresco-upstream main --squash

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Make your changes
4. Lint your charts (helm lint charts/<chart-name>)
5. Commit your changes (git commit -m 'feat: add new feature')
6. Push to the branch (git push origin feature/my-feature)
7. Open a Pull Request

This project follows Conventional Commits:

• feat: - New features
• fix: - Bug fixes
• docs: - Documentation changes
• ci: - CI/CD changes
• chore: - Maintenance tasks

This project is licensed under the Apache License 2.0.

The Alfresco Helm Charts included in this repository (charts/alfresco/) are Copyright © Alfresco Software, Ltd. and are also distributed under the Apache License 2.0.