dokploy-upgrade

Automate Dokploy PaaS upgrades on Docker Swarm with rollback capability.

12|3|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/Fei2-Labs/skill-genie --skill dokploy-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dokploy-upgrade
Source: https://github.com/Fei2-Labs/skill-genie/tree/main/skills/dokploy-upgrade
Command: npx skills add https://github.com/Fei2-Labs/skill-genie --skill dokploy-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of upgrading Dokploy on a VPS running Docker Swarm, ensuring a smooth update with version checks and rollback options.

Core Features & Use Cases

  • Version Detection: Automatically identifies the current Dokploy version and checks for the latest release.
  • Breaking-Change Review: Reviews release notes for potential issues before upgrading.
  • Pre-flight Health Check: Ensures all Docker Swarm services are healthy before proceeding with the upgrade.
  • Upgrade Execution: Runs the official install.sh script to update Dokploy, handling port conflicts.
  • Post-upgrade Verification: Confirms the upgrade's success by checking service health and container status.
  • Rollback Capability: Provides a procedure to revert to the previous version if necessary.
  • Use Case: When a user needs to update their Dokploy instance to the latest version or a specific release, this Skill can be used to automate the process.

Quick Start

Use the dokploy-upgrade skill to upgrade Dokploy to the latest version on the host 'my-vps'.

Frequently Asked Questions about dokploy-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade Dokploy on Docker Swarm safely?

Upgrading Dokploy on Docker Swarm involves running the official install.sh script via SSH, which this automation wraps with pre-flight health checks, breaking-change reviews, and rollback capabilities to ensure a smooth update.

Can I rollback a Dokploy update if the upgrade fails?

Yes, you can rollback a Dokploy update if the upgrade fails. The process includes post-upgrade verification of service health and container status, triggering a rollback procedure to revert to the previous version when necessary.

What do I need to automate a Dokploy PaaS upgrade on a VPS?

To automate a Dokploy PaaS upgrade on a VPS, you need SSH access to the host machine running Docker Swarm and the official Dokploy install.sh script to execute the version update and health checks.

Does the Dokploy upgrade process check for breaking changes?

Yes, the Dokploy upgrade process checks for breaking changes. It automatically identifies your current version, checks for the latest release, and reviews the release notes for potential issues before proceeding with the update.

What happens if Docker Swarm services are unhealthy before a Dokploy upgrade?

If Docker Swarm services are unhealthy before a Dokploy upgrade, the pre-flight health check prevents the update from proceeding, ensuring that the system is stable and ready before executing the install.sh script.