Skip to content

Applications & Infrastructure

Comprehensive documentation for all Kubernetes deployments, organized by category and environment.

📋 Quick Navigation

👤 User Applications

All user-facing applications for daily use and productivity: - Communication, media, productivity, utilities, dashboards - View All Applications →

🔧 Infrastructure Services

Core services supporting the cluster and applications: - Networking, monitoring, storage, security, utilities - View Infrastructure →

🌍 Other Services

Additional components and specialized services: - Routing, authentication, DNS, dashboards - View Other Services →

🏗️ Cluster Management

Kubernetes cluster setup, GitOps, and cluster components: - Flux, k3s, development, production environments - View Cluster Documentation →

📊 Application Directory

Category Services Purpose
User Apps 14 applications Daily tools and utilities
Infrastructure 16 services Core cluster support
Other 8 services Routing, auth, utilities
Clusters 4 configs k3s and GitOps

🗂️ File Organization

apps/
├── apps/           # User applications (14 apps)
├── infrastructure/ # Core infrastructure (16 services)
├── other/          # Routing, auth, utilities (8 services)
├── clusters/       # Cluster management (4 configs)
└── index.md        # This page

🚀 Getting Started

  1. Review Architecture → Start with System Architecture
  2. Choose Your Interest → Select category above
  3. Read Component Docs → Each has overview, config, resources
  4. Check Manifests → Links to actual Kubernetes YAML

🔍 Common Tasks

Deploy a New Application

  1. Create folder: apps/base/<app-name>/
  2. Add manifests: deployment.yaml, service.yaml, ingress.yaml
  3. Create kustomization.yaml in folder
  4. Create documentation in docs/apps/apps/<APP-NAME>.md
  5. Update docs/apps/apps/index.md
  6. Commit and push (Flux will auto-deploy)

Access an Application

  1. Find application DNS in docs
  2. Add DNS record to point to your network
  3. Use Authelia for SSO if configured
  4. Access via: https://app.yourdomain.com

Monitor Application Health

  1. Check Prometheus metrics: https://prometheus.yourdomain.com
  2. View logs in Loki: https://loki.yourdomain.com
  3. Use Skooner dashboard: https://skooner.yourdomain.com

📕 Documentation Standards

Each application documentation includes: - 📝 Overview and purpose - 🏗️ Architecture diagram - ✨ Key features - 📦 Prerequisites and dependencies - ⚙️ Configuration options - 📊 Resource requirements (CPU, memory, storage) - 🔗 File links to deployment manifests - 🌐 External links and documentation

🔐 Security Practices

  • All external traffic through Traefik with TLS
  • Sealed Secrets for sensitive data
  • Authelia for SSO/MFA protection
  • Network policies between namespaces
  • Regular security updates