Docs
Deployments
vps-deployer deploy my-next-app
vps-deployer deploy my-next-app --commit <sha> --wait
The CLI and webhook only enqueue work. A worker on this VPS:
- Creates a new release directory
- Fetches the repository and checks out the commit
- Installs dependencies and builds
- Starts a candidate on
127.0.0.1:<port>when the runtime needs a process - Health-checks the candidate
- Switches
currentonly after the candidate is healthy - Marks
SUCCESSorFAILED
A failed candidate must not replace a working current release. One RUNNING deployment per project. Additional requests stay QUEUED (FIFO).
Release files live under /var/www/apps/<project>/releases/. current is a symlink. Default retention is 5 successful releases. The active release is never deleted.