Files
stack/docs/CHANGELOG.md
Jason Woltje 6521cba735
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
feat: add flexible docker-compose architecture with profiles
- Add OpenBao services to docker-compose.yml with profiles (openbao, full)
- Add docker-compose.build.yml for local builds vs registry pulls
- Make PostgreSQL and Valkey optional via profiles (database, cache)
- Create example compose files for common deployment scenarios:
  - docker/docker-compose.example.turnkey.yml (all bundled)
  - docker/docker-compose.example.external.yml (all external)
  - docker/docker.example.hybrid.yml (mixed deployment)
- Update documentation:
  - Enhance .env.example with profiles and external service examples
  - Update README.md with deployment mode quick starts
  - Add deployment scenarios to docs/OPENBAO.md
  - Create docker/DOCKER-COMPOSE-GUIDE.md with comprehensive guide
- Clean up repository structure:
  - Move shell scripts to scripts/ directory
  - Move documentation to docs/ directory
  - Move docker compose examples to docker/ directory
- Configure for external Authentik with internal services:
  - Comment out Authentik services (using external OIDC)
  - Comment out unused volumes for disabled services
  - Keep postgres, valkey, openbao as internal services

This provides a flexible deployment architecture supporting turnkey,
production (all external), and hybrid configurations via Docker Compose
profiles.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-08 16:55:33 -06:00

3.2 KiB

Changelog

All notable changes to Mosaic Stack will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Added

  • Complete turnkey Docker Compose setup with all services (#8)
    • PostgreSQL 17 with pgvector extension
    • Valkey (Redis-compatible cache)
    • Authentik OIDC provider (optional profile)
    • Ollama AI service (optional profile)
    • Multi-stage Dockerfiles for API and Web apps
    • Health checks for all services
    • Service dependency ordering
    • Network isolation (internal and public networks)
    • Named volumes for data persistence
    • Docker Compose profiles for optional services
  • Traefik reverse proxy integration (#36)
    • Bundled mode: Self-contained Traefik instance with automatic service discovery
    • Upstream mode: Connect to external Traefik instances
    • None mode: Direct port exposure without reverse proxy
    • Automatic SSL/TLS support (Let's Encrypt or self-signed)
    • Traefik dashboard for monitoring routes and services
    • Flexible domain configuration via environment variables
    • Integration tests for all three deployment modes
    • Comprehensive deployment guide with production examples
  • Comprehensive environment configuration
    • Updated .env.example with all Docker variables
    • PostgreSQL performance tuning options
    • Valkey memory management settings
    • Authentik bootstrap configuration
  • Docker deployment documentation
    • Complete deployment guide
    • Docker-specific configuration guide
    • Updated installation instructions
    • Troubleshooting section
    • Production deployment considerations
  • Integration testing for Docker stack
    • Service health check tests
    • Connectivity validation
    • Volume and network verification
    • Service dependency tests
  • Docker helper scripts
    • Smoke test script for deployment validation
    • Makefile for common operations
    • npm scripts for Docker commands
  • docker-compose.override.yml.example template for customization
  • Environment templates for Traefik deployment modes
    • .env.traefik-bundled.example for bundled mode
    • .env.traefik-upstream.example for upstream mode

Changed

  • Updated README.md with Docker deployment instructions
  • Enhanced configuration documentation with Docker-specific settings
  • Improved installation guide with profile-based service activation
  • Updated Makefile with Traefik deployment shortcuts
  • Enhanced docker-compose.override.yml.example with Traefik examples

0.0.1 - 2026-01-28

Added

  • Initial project structure with pnpm workspaces and TurboRepo
  • NestJS API application with BetterAuth integration
  • Next.js 16 web application foundation
  • PostgreSQL 17 database with pgvector extension
  • Prisma ORM with comprehensive schema
  • Authentik OIDC authentication integration
  • Activity logging system
  • Authentication module with OIDC support
  • Database seeding scripts
  • Comprehensive test suite with 85%+ coverage
  • Documentation structure (Bookstack-compatible hierarchy)
  • Development workflow and coding standards