PatchPanda

PatchPanda is a release-oriented Docker Compose stack update manager built with .NET and Blazor Server. It discovers running compose projects, tracks GitHub releases for images, surfaces release notes, and helps you review and apply coordinated updates while keeping control of your compose files.

Key Features

• Discover running Docker Compose projects and list services with current image tags
• Extract GitHub repository info from image labels/OCI annotations and query GitHub releases
• Heuristics and regex-based tag matching to select valid version candidates
• Group related containers into multi-container applications for coordinated updates
• Edit docker-compose/.env files and run docker compose pull + up to apply updates
• Notifications via Apprise-compatible endpoints and native Discord webhooks
• Optional Portainer API integration to manage stacks Portainer controls
• Optional AI-powered release-note summarization and breaking-change/security analysis via Ollama-compatible LLMs
• Update queue, live update logs, attempt history, and error handling with best-effort rollback
• Support for automatic non-breaking updates configurable per-settings

Use Cases

• Keep a fleet of Docker Compose stacks up to date while reviewing release notes before applying changes
• Coordinate multi-container application updates (web + worker + db migrations) with grouped updates
• Send notifications about new releases to chat/email and optionally auto-apply safe updates

Limitations and Considerations

• Beta software: not guaranteed for critical production automation; test and have backups and recovery plans
• Requires access to the Docker socket and host paths for compose files; host/ container path mappings must match for discovery and editing
• GitHub personal access token is required for release queries; private repos need repo scope
• AI features (summaries, breaking-change/security analysis) require an Ollama-compatible endpoint and model configuration
• May not cover all edge cases of complex compose setups; manual verification of update plans is recommended

PatchPanda is designed for environments where release notes and coordinated updates matter, offering a conservative, review-first approach to updating Docker Compose stacks. It combines release-awareness, notifications, and optional LLM-assisted analysis to reduce surprise regressions while keeping the underlying compose files editable and auditable.