basicstack/stack.basicstack.de
2
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions
stack.basicstack.de/apps/stalwart
History
CTO Agent f981b3e269 Initialize CD/CI repository structure with Stalwart example 
Set up the repository structure following GitOps principles:
- apps/ for application deployments (Stalwart as example)
- infrastructure/ for cluster-wide configs (networking, monitoring)
- docs/ for general documentation

Migrated complete Stalwart deployment configuration including:
- Multiple deployment variants (basic, OIDC-enabled)
- Helm values files
- Monitoring and dashboard configurations
- Operational documentation (backup/restore, bootstrap)
- Configuration patches and fixes

Added comprehensive README files at each level to guide future use.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-07-01 18:08:31 +00:00
..
README.md Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-backup-restore.md Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-bootstrap-completion-guide.md Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-config-complete.json Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-config-fix-v2.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-config-fix.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-config-with-data.json Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-console-pod.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-dashboard-configmap.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-deployment-new.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-deployment-oidc-only.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-deployment-with-oidc.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-deployment.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-grafana-dashboard.json Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-helm-fix.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-helm-values-oidc.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-monitoring.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-oidc-config.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-service-patch.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-statefulset-patch-v2.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-statefulset-patch-v3.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-statefulset-patch.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-values-correct.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-values-fixed-ports.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00
stalwart-values.yaml Initialize CD/CI repository structure with Stalwart example 2026-07-01 18:08:31 +00:00

README.md

Stalwart Mail Server Deployment

This directory contains the complete deployment configuration for the Stalwart mail server on the basicstack.de cluster.

Files Overview

Deployment Manifests

  • stalwart-deployment.yaml - Basic deployment configuration
  • stalwart-deployment-new.yaml - Updated deployment variant
  • stalwart-deployment-with-oidc.yaml - Deployment with OIDC integration
  • stalwart-deployment-oidc-only.yaml - OIDC-only authentication deployment

Helm Configuration

  • stalwart-values.yaml - Main Helm values file
  • stalwart-values-fixed-ports.yaml - Values with corrected port configurations
  • stalwart-values-correct.yaml - Verified correct values
  • stalwart-helm-values-oidc.yaml - Helm values for OIDC setup
  • stalwart-helm-fix.yaml - Helm chart fixes

Configuration

  • stalwart-oidc-config.yaml - OIDC provider configuration
  • stalwart-config-fix.yaml - Configuration corrections
  • stalwart-config-fix-v2.yaml - Updated configuration fix

Monitoring

  • stalwart-monitoring.yaml - Prometheus ServiceMonitor and metrics
  • stalwart-dashboard-configmap.yaml - Grafana dashboard configuration

Maintenance

  • stalwart-console-pod.yaml - Debug/console pod for troubleshooting
  • stalwart-service-patch.yaml - Service configuration patch
  • stalwart-statefulset-patch.yaml - StatefulSet patches (v1, v2, v3)

Documentation

  • stalwart-backup-restore.md - Backup and restore procedures
  • stalwart-bootstrap-completion-guide.md - Initial setup guide

Deployment Notes

This is a reference implementation showing the evolution of a production deployment. Multiple variants are preserved to show:

  • Different authentication strategies (local vs. OIDC)
  • Configuration iterations and fixes
  • Monitoring integration
  • Operational procedures

When deploying a new service, you don't need this many files - choose the appropriate manifest for your use case and adapt it.

Current Production Deployment

Review the files to determine which manifest represents the current production state, or check the cluster directly with:

kubectl get deployment,statefulset -n stalwart