Skip to main content
Deploying applications on Unkey is in public beta. To try it, select Projects in the dashboard sidebar and create a project. Deployed resources are free until August 1, 2026. We’re eager for feedback, so let us know what you think on Discord, X, or email support@unkey.com.
When a deployment causes issues, you can roll back to a previous version instantly. Rollbacks switch traffic atomically, so there’s no downtime during the transition.

​
Roll back a deployment

  1. Open your project’s Deployments tab.
  2. Click the three-dot menu on the deployment you want to revert to.
  3. Select Rollback.
Deployment context menu

Deployment context menu with rollback, promote, and redeploy options

  1. Review the current deployment, affected domains, and target deployment in the confirmation dialog.
  2. Click Rollback to target version.
Rollback confirmation dialog

Rollback confirmation showing current and target deployments

Unkey reassigns the environment and branch domains to point to the target deployment immediately. The previous deployment stays running until routes are fully switched, so no requests are dropped.

​
What happens after a rollback

After a rollback, the affected environment enters a rolled-back state. This only applies to the environment where you triggered the rollback (for example, production). Other environments are unaffected. In a rolled-back environment:
  • The target deployment is serving traffic.
  • New pushes to the branch still create deployments, but domains don’t get reassigned to them automatically.
  • The dashboard indicates that the environment is running a rolled-back version.
This prevents a new push from undoing your rollback. You stay on the rolled-back version until you explicitly promote a deployment.

​
Promote a deployment

Promoting a deployment reassigns domains to point to it and restores normal behavior. After promoting, the next successful deployment from a push automatically receives traffic again.
  1. Open your project’s Deployments tab.
  2. Click the three-dot menu on the deployment you want to promote.
  3. Select Promote.

​
Rolling forward vs rolling back

Rolling back is faster since it reuses an existing, known-good deployment. Rolling forward (pushing a fix) creates a new deployment and goes through the full build and deploy pipeline.
In production, previous deployments stay running for 30 minutes after a new version goes live, then spin down. In preview environments, deployments stay running until they’ve been idle (zero requests) for 1 hour. Rolling back to a running deployment is instant. Rolling back to a spun-down deployment is still possible, but takes longer because the containers need to start up again. See instant rollbacks for details.

​
Next steps

Deployment lifecycle

How deployments progress from build to serving traffic

Builds

How Unkey builds your container images
Last modified on June 24, 2026