stack.basicstack.de/docs/README.md

# Documentation

This directory contains general documentation for the basicstack.de cluster and deployment processes.

## Available Documentation

- **[Argo CD - GitOps Platform](argocd.md)**: Comprehensive guide to the Argo CD deployment, including SSO login, managing applications, repository credential rotation, emergency recovery, and troubleshooting

## Suggested Future Content

- **Architecture**: Overall cluster architecture and design decisions
- **Deployment Guides**: Step-by-step deployment procedures for specific scenarios
- **Troubleshooting**: Common cluster-wide issues and solutions
- **Best Practices**: Standards and conventions for this cluster
- **Operations Runbooks**: Incident response and operational procedures
- **Disaster Recovery**: Backup and restore procedures at the cluster level

## Note

Application-specific documentation should live in the respective `apps/<app-name>/` directories, not here. This directory is for cross-cutting concerns and cluster-wide documentation.
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			`# Documentation`

			`This directory contains general documentation for the basicstack.de cluster and deployment processes.`

Add comprehensive Argo CD documentation Created detailed documentation covering: - Authentication and SSO login flow - Adding new applications (Git and UI methods) - Repository credential rotation procedure - Emergency recovery procedures (with critical safety warnings) - Self-management architecture - Monitoring, maintenance, and troubleshooting - Backup and disaster recovery Updated README.md with Argo CD section and links to docs. Updated docs/README.md to index the new Argo CD documentation. Co-Authored-By: Paperclip <noreply@paperclip.ing> 2026-07-12 10:04:51 +00:00			`## Available Documentation`

			`- [Argo CD - GitOps Platform](argocd.md): Comprehensive guide to the Argo CD deployment, including SSO login, managing applications, repository credential rotation, emergency recovery, and troubleshooting`

			`## Suggested Future Content`
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
			`- Architecture: Overall cluster architecture and design decisions`
Add comprehensive Argo CD documentation Created detailed documentation covering: - Authentication and SSO login flow - Adding new applications (Git and UI methods) - Repository credential rotation procedure - Emergency recovery procedures (with critical safety warnings) - Self-management architecture - Monitoring, maintenance, and troubleshooting - Backup and disaster recovery Updated README.md with Argo CD section and links to docs. Updated docs/README.md to index the new Argo CD documentation. Co-Authored-By: Paperclip <noreply@paperclip.ing> 2026-07-12 10:04:51 +00:00			`- Deployment Guides: Step-by-step deployment procedures for specific scenarios`
			`- Troubleshooting: Common cluster-wide issues and solutions`
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			`- Best Practices: Standards and conventions for this cluster`
			`- Operations Runbooks: Incident response and operational procedures`
			`- Disaster Recovery: Backup and restore procedures at the cluster level`

			`## Note`

			Application-specific documentation should live in the respective `apps/<app-name>/` directories, not here. This directory is for cross-cutting concerns and cluster-wide documentation.