Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.slipway.sh/llms.txt

Use this file to discover all available pages before exploring further.

Push and PR deploys cover the common path. Manual deploys are for everything else: trying out a stale commit, repro-ing a bug on a specific SHA, or grabbing a five-minute preview without opening a PR.

​
Redeploy

From the deployment detail page, Redeploy re-runs orchestration for the deployment’s commit. The new run gets a fresh deployment row, a fresh tenant namespace, and a fresh URL. The original deployment stays in history. Common reasons to redeploy:
  • A build dependency outside your repo (npm registry, base image) changed and you want the freshest build.
  • The previous deployment failed transiently — image pull timed out, healthcheck flapped — and a retry should work.
  • You changed a secret or variable value and want it to take effect.

​
Deploy ephemeral

From a repo detail page, the Deploy action creates a deployment for a chosen commit (defaults to the default branch HEAD) with a TTL.
FieldDefaultNotes
Branchdefault branchManual deploys are scoped to the default branch.
CommitHEAD of branch
TTL5 minutesThe countdown starts when status flips to healthy.
The deployment’s URL works like any other (<short-id>-<rand>.<apps-base>). When the TTL elapses, slipway deletes the tenant namespace and marks the deployment superseded. A gc event records ephemeral ttl expired. If you need the preview to live longer, redeploy with a longer TTL — there’s no way to extend an in-flight TTL today.

​
When the TTL clock starts

The clock starts on healthy, not on created. A slow build doesn’t eat into your preview window. This matters when you’re testing a heavy image — a 90-second build won’t shorten your 5-minute preview.

​
What you can’t change after enqueue

  • The trigger. Manual is manual; you can’t promote an ephemeral to a non-ephemeral.
  • The branch. Manual deploys can’t target non-default branches.
  • The TTL. You can’t extend or shorten the timer once it’s running.
If you need different parameters, redeploy.