Skip to content

Conversation

@ivanpadavan
Copy link

What is this PR about?

This PR introduces a new Patches system for Applications and Docker Compose services — a powerful way to customize deployments directly from the dashboard without maintaining complex forks.

While there are many "ready-to-work" repositories available, most require slight modifications to run correctly on a self-hosted instance. This feature dramatically improves the user experience by making it easy to apply small, persistent fixes to any service.

How It Works:
Users can apply persistent modifications (Git patches) to source code or configuration files (like docker-compose.yml) directly from the Dokploy UI. These patches are automatically applied before every build or deployment.

Key Features:

  • Persistent Customization: Changes survive redeployments and updates from the upstream repository.
  • In-Browser Editor: A new "Patches" tab allows users to browse files, edit content, and generate patches automatically without leaving the browser.
  • Safety: Uses standard git apply mechanics; if the source file changes drastically, the patch fails safely, preventing silent breakages.

Implementation Details:

  • Backend: introduced a Patch entity and a PatchService to handle git operations (clone, diff, apply).
  • Deployment Pipeline: Integrated a patch application step into the deployment workflow for both Applications and Compose services.
  • Frontend: Added a file browser and code editor for managing patches.

I understand that the UI/UX and test coverage are open points for discussion. If you are open to including this feature in the product, I am ready to polish it further based on your feedback.

You can preview the implementation here: https://github.com/ivanpadavan/dokploy-patches

Checklist

Before submitting this PR, please make sure that:

Issues related (if applicable)

(If there is a feature request issue for this, link it here, e.g. closes #123)

Screenshots

Patches Tab (Empty State)
Patches Tab

Creating/Editing a Patch
Edit Patch

Patches List
Patches List

@ivanpadavan ivanpadavan changed the title Patches impl feat: Add patches functionality Jan 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant