selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
PatchPanda logo

Self-host PatchPanda

v0.11.2

Docker Compose update manager with release notes

BetaOpen SourceMIT
Updated6 months ago
LanguageC
Setup difficultyModerate
Stars
346
Port
8080 (HTTP web UI)
Requires
Docker Engine, GitHub API, SQLite
Docker
ghcr.io/dkorecko/patchpanda
Install with Docker Compose
Homepage showing discovered Docker Compose stacksPage with release notes and ability to updateOngoing update with live log outputQueue page showing pending updatesUpdate Attempts page with historyOutput of an update attemptSettings pageNotifications pageDiscord notification exampleDiscord auto-update notifications

What is PatchPanda?

PatchPanda is a self-hosted application that helps you keep Docker Compose stacks current. It discovers running compose projects, reads GitHub repository details from image labels or OCI annotations, and checks GitHub releases for newer versions. The UI presents release notes, flags breaking changes, and groups related services so they can be updated together. When you approve an update, the tool rewrites the relevant compose or .env files and runs the standard docker compose pull and up commands. Notifications can go to Discord or any Apprise target. Optional integrations include Portainer for managed stacks and Ollama-compatible LLMs for AI-generated summaries and security scanning of code diffs. Data lives in a SQLite database. The project is in beta; the authors advise testing before production use.

Should you self-host PatchPanda?

PatchPanda scores 45/100 on selfhost.directory (how scoring works) and ranks #29 of 44 in Container Management. It has 346 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v0.11.2, came out on 25 April 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in C.

Its closest alternative on selfhost.directory is drydock (53/100, 271 stars). It scores higher overall, so compare the two before you pick. See PatchPanda vs drydock side by side.

Features

  • AI release note summarizationRequires OLLAMA_URL to be configured
  • Apprise notifications
  • Automatic non-breaking updates
  • Breaking Change Detection
  • Discord Notifications
  • Docker Compose stack discovery
  • GitHub release monitoring
  • Manual GitHub repo override
  • Multi-container app grouping
  • Release notes display
  • Security ScanningRequires OLLAMA_URL to be configured
  • Update execution
  • Update history and rollback
  • Version ignore

PatchPanda README

How to install PatchPanda

Install PatchPanda with Docker Compose

Docker Engine with host socket access; host path containing compose files must be mounted at same path in container
Environment variables
BASE_URL, GITHUB_USERNAME, GITHUB_PASSWORD, DISCORD_WEBHOOK_URL, APPRISE_API_URL, APPRISE_NOTIFICATION_URLS, OLLAMA_URL, OLLAMA_MODEL, OLLAMA_NUM_CTX, PORTAINER_URL, PORTAINER_IGNORE_SSL, PORTAINER_ACCESS_TOKEN, PORTAINER_USERNAME, PORTAINER_PASSWORD

services: patchpanda: container_name: patchpanda-app image: ghcr.io/dkorecko/patchpanda:latest environment: - APPRISE_API_URL=http://apprise-api:8000 - APPRISE_NOTIFICATION_URLS=discord://webhook_id/webhook_token,mailto://user:password@gmail.com - DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/... - GITHUB_USERNAME=yourusername - GITHUB_PASSWORD=yourtoken - BASE_URL=http://localhost:5093 - PORTAINER_URL=http://portainer:9000 - PORTAINER_IGNORE_SSL=true - PORTAINER_ACCESS_TOKEN=your_token - PORTAINER_USERNAME=admin - PORTAINER_PASSWORD=CHANGEME - OLLAMA_URL=http://localhost:11434 - OLLAMA_MODEL=llama3 - OLLAMA_NUM_CTX=32768 volumes: - /var/run/docker.sock:/var/run/docker.sock:rw - /srv/www:/srv/www:rw - ./data:/app/data:rw ports: - "5093:8080" restart: unless-stopped

Requires mounting Docker socket and a path containing compose files. Adjust volume paths for your setup.

How to configure PatchPanda

  • APPRISE_API_URLAn Apprise API URL to send notifications to any services Apprise supports

    An Apprise API URL to send notifications to any services Apprise supports

  • APPRISE_NOTIFICATION_URLSA comma-separated list of Apprise notification URLs

    A comma-separated list of Apprise notification URLs

  • BASE_URLThe base URL of PatchPanda, used for creating clickable URLs in notifications

    The base URL of PatchPanda, used for creating clickable URLs in notifications

  • DISCORD_WEBHOOK_URLFull Discord webhook URL used to post notifications

    Full Discord webhook URL used to post notifications

  • GITHUB_PASSWORDGitHub personal access token (PAT) or password

    GitHub personal access token (PAT) or password

  • GITHUB_USERNAMEGitHub username

    GitHub username

  • OLLAMA_MODELModel name to use for summarization and security analysis

    Model name to use for summarization and security analysis

  • OLLAMA_NUM_CTX32768Context size to be used for summarization and security analysis

    Context size to be used for summarization and security analysis

  • OLLAMA_URLBase URL to your Ollama or compatible LLM API

    Base URL to your Ollama or compatible LLM API

  • PORTAINER_ACCESS_TOKENAccess token for Portainer API authentication

    Access token for Portainer API authentication

  • PORTAINER_IGNORE_SSLIgnore SSL certificate validation for Portainer API requests

    Ignore SSL certificate validation for Portainer API requests

    values: true

  • PORTAINER_PASSWORDPassword for Portainer API authentication (legacy)

    Password for Portainer API authentication (legacy)

  • PORTAINER_URLBase URL to your Portainer instance

    Base URL to your Portainer instance

  • PORTAINER_USERNAMEUsername for Portainer API authentication (legacy)

    Username for Portainer API authentication (legacy)

PatchPanda releases & version history

More in Deployment

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…