What Is a Symlink Swap Deploy?
A symlink swap deploy stages each release in its own directory and exposes the live one through a stable symlink such as current. Releasing means atomically repointing that symlink to the new directory, which flips the active version in a single operation. Rolling back is simply pointing the symlink at the previous directory.
Why it matters
Because the symlink update is atomic, no request ever sees a partially copied release, and the switch is effectively instant. Keeping several past release directories makes rollback a near-zero-cost pointer change. The trade-off is disk space for retained releases and care that processes pick up the new path on swap.
Related guides
What Is an Atomic Deploy?An atomic deploy switches traffic to a fully prepared new release in a single instant, so users never see a h…
What Is a Branch Deploy?A branch deploy publishes a deployment built from a specific branch, letting teams preview or release work fr…
What Is Environment Promotion?Environment promotion advances a release from one environment to the next, such as staging to production, aft…