basicstack/stack.basicstack.de
2
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions
stack.basicstack.de/apps/stalwart/README.md
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

2.1 KiB
Raw Blame History

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