Rollbacks
Learn how to rollback your application in Nomploy.
Rollbacks are a powerful feature that allows you to easily revert changes to your application. This is particularly useful when you encounter issues or want to revert to a previous version of your application.
How rollbacks work
Nomploy supports registry-based rollbacks: every deployment's image is tagged and pushed to your configured registry, so you can roll back to any specific previous deployment at any time — not just the most recent one.
How Registry-based Rollbacks Work
When using registry-based rollbacks, Nomploy:
- Saves each deployment's image to your configured registry: Every time you deploy, the built image is tagged and pushed to your Docker registry (Docker Hub, GHCR, etc.)
- Associates each deployment with its image: Each deployment record in Nomploy is linked to a specific image tag in your registry
- Enables rollback to any deployment: You can rollback to any previous deployment by using the image that was saved during that deployment
This approach gives you:
- ✅ Works with any deployment: Not limited to health check failures
- ✅ Rollback to any version: Can rollback to any previous deployment, not just the immediate previous one
- ✅ Uses registry storage: Images are stored in your registry, making them persistent and accessible
Registry-based rollbacks require that your application is configured to use a Docker registry. The images are automatically pushed to your registry during each deployment, and Nomploy tracks which image corresponds to each deployment.
Prerequisites for Registry-based Rollbacks
To use registry-based rollbacks, you need:
- A configured Docker registry in Nomploy (Docker Hub, GHCR, or custom registry)
- Registry credentials set up in Nomploy's registry settings
- Application configured to push images to the registry during deployment
When you enable rollbacks, Nomploy will automatically push each deployment's image to your configured registry with a unique tag, allowing you to rollback to any specific deployment version.
Enabling Registry-based Rollbacks
To start saving deployment images to your registry for rollbacks:
- Navigate to your application
- Go to Deployments → Rollback Settings
- Enable the Rollback option
- Select the registry you want to use for rollbacks
- Click on Save
Once enabled, Nomploy will:
- Automatically tag and push images: Every deployment's image is tagged and pushed to your configured registry
- Track deployment associations: Each deployment is linked to its specific image tag in the registry
- Enable rollback buttons: You'll see a Rollback button next to each deployment in the Deployments section
Performing a Registry-based Rollback
- Go to your application's Deployments section
- Find the deployment version you want to rollback to
- Click the Rollback button next to that deployment
- Confirm the rollback action
After clicking Rollback, you'll need to wait a few seconds for Nomploy to download the image from your registry. The container will not appear in the Logs tab immediately - wait a moment for the image download to complete before checking the logs to see the container running.