SKMemory - SKStacks Framework Knowledge Base

Structure

memory/
├── short-term/
│   └── sessions/
│       ├── 20251101-traefik-v3-migration.md      # Traefik v3.5 migration session
│       ├── 20251103-skmon-implementation.md      # SKMon implementation session
│       ├── 20251105-traefik-logs-runtime-location.md  # Traefik logs location (superseded by log standardization)
│       ├── 20251105-docker-volumes-domain-awareness.md  # Docker volumes and domain awareness updates
│       ├── 20251105-multi-cluster-inventory.md   # Multi-cluster Ansible inventory structure
│       ├── 20251105-log-location-standardization.md  # Log directory standardization to /var/data/logs/
│       └── 20251107-vault-management-enhancements.md  # Multi-domain multi-cluster vault management and template generation
└── long-term/
    ├── traefik-v3-swarm-configuration.md         # Traefik v3.5 Swarm config guide
    ├── docker-swarm-service-naming.md            # Service naming standards
    ├── volume-management-nfs.md                   # Volume management guide
    ├── skmon-monitoring-stack.md                  # SKMon monitoring stack
    └── skai-ai-voice-assistant.md                # SKAI service documentation

Content Summary

Short-Term (Session Memory)

• 20251101-traefik-v3-migration.md: Complete session log of Traefik v3.5 migration on norap1001 production cluster
• 20251103-skmon-implementation.md: Complete implementation of SKMon monitoring stack with Grafana plugins and dashboards
• 20251105-traefik-logs-runtime-location.md: Initial migration of Traefik logs (superseded by log location standardization)
• 20251105-docker-volumes-domain-awareness.md: Comprehensive updates for Docker volume management (NFS compatibility) and domain-aware configuration
• 20251105-multi-cluster-inventory.md: Multi-cluster Ansible inventory structure supporting clusters with same name but different domains
• 20251105-log-location-standardization.md: Standardization of log directory location to /var/data/logs/ for better discoverability and industry-standard alignment
• 20251107-vault-management-enhancements.md: Comprehensive vault management system enhancements including multi-domain multi-cluster support, automatic template generation from service configs, and skk8s (Kubernetes) integration

Long-Term (Persistent Knowledge)

Infrastructure & Configuration

• traefik-v3-swarm-configuration.md: Comprehensive guide for Traefik v3.5 in Swarm mode

  • Provider configuration (swarm vs docker)
  • Socket-proxy setup (NODES=1 requirement)
  • Constraint syntax
  • Troubleshooting guide

• docker-swarm-service-naming.md: Standardized naming conventions

  • Stack naming pattern: {service}-{env}
  • Service naming pattern: {component} (no env suffix)
  • Result pattern: {stack-name}_{service-name}

• volume-management-nfs.md: Docker volume management for NFS compatibility

  • Problem: NFS filesystem detection errors
  • Solution: Docker volumes with local driver
  • Implementation patterns
  • When to use vs bind mounts

Services

• skmon-monitoring-stack.md: Complete SKMon monitoring and logging stack documentation

  • ELK Stack (Elasticsearch, Logstash, Kibana)
  • Prometheus and Grafana
  • Filebeat and cAdvisor
  • Service integration points
  • Dashboard configurations
  • Deployment and operations

• skai-ai-voice-assistant.md: SKAI AI voice assistant service documentation

  • Components (Ollama, LocalAI, Open-WebUI, Whisper, Piper)
  • Architecture and storage
  • SKMon integration
  • External service dependencies

Service Integration Summary

Core Services

• SKFence: Traefik logs and metrics automatically collected
• SKSec: Security event logs and container monitoring
• SKBackup: Container monitoring and log collection

Optional Services

• SKVector: Qdrant container monitoring and placeholder metrics dashboard
• SKGit: Forgejo container monitoring and placeholder metrics dashboard
• SKStor: MinIO container monitoring
• SKSync: Syncthing container monitoring
• SKorch: n8n container monitoring
• SKAI: All AI component container monitoring

Monitoring Stack

• SKMon: Complete monitoring and logging stack
  • ELK Stack for centralized logging
  • Prometheus for metrics collection
  • Grafana for visualization
  • cAdvisor for container metrics
  • Filebeat for log collection

Tags

All documents tagged with: traefik-v3.5, docker-swarm, socket-proxy, crowdsec, service-discovery, volume-management, nfs-compatibility, service-naming, skmon, monitoring, grafana, prometheus, elasticsearch, kibana, cadvisor, filebeat, skai, ai, voice-assistant, llm, vault-management, ansible-vault, multi-cluster, domain-aware, template-generation, skk8s, kubernetes

Next Steps

Once Qdrant is running and SKMemory is fully initialized:

1. Sync these files to the memory submodule
2. Run semantic indexing
3. These will be searchable via SKMemory vector search

Related Documentation

• Framework standards: v1/docs/FRAMEWORK_STANDARDS.md
• Volume management: v1/docs/VOLUME_MANAGEMENT_STANDARDS.md
• Logging standards: v1/docs/LOGGING_MONITORING_STANDARDS.md
• SKMon documentation: v1/ansible/optional/skmon/README.md
• Service READMEs: v1/ansible/{core,optional}/*/README.md