Deploy Command
Deploy from the directory linked to your Slipway project:
slipway whoami
slipway environments
slipway slide --env staging --app web --message "Fix login validation"slide packages source, uploads it, starts a deployment, and watches progress. deploy and launch are aliases.
Target and options
| Option | Meaning |
|---|---|
--env, -e | Environment slug; defaults to production |
--app, -a | App slug; defaults to the environment's default app |
--message, -m | A note stored with the deployment |
The project comes from .slipway.json; use slipway link PROJECT_SLUG when deploying an existing project from another directory. The server comes from saved credentials, not a global --server option.
The command does not support --dry-run, --no-cache, --verbose, --quiet, or --canary. Use the readiness report to inspect uploaded source before deployment.
What source is deployed?
In a Git repository, slide and push package git archive HEAD. Commit the intended files first: uncommitted changes and untracked files are not uploaded. Outside a Git repository, packaging uses tar and excludes node_modules, .git, .env, .DS_Store, and log files. Inspect your source for credentials before uploading; exclusions do not make arbitrary source safe.
Inspect, deploy, verify
npm test
slipway push
slipway readiness --env staging --app web --json
slipway slide --env staging --app web --message "Reviewed startup fix"
slipway deployments --env staging --limit 5
curl --fail https://STAGING_APP_DOMAIN/healthThe readiness report must correspond to the intended source and configuration. After a change, refresh it. slide uploads its source again and records that revision for the deployment.
The CLI prints a deployment ID and watches the attempt through a stream, falling back to polling. Check the final deployment state and the app's expected behavior. A zero process exit alone does not establish success: timeout or cancelled states may be reported without the app becoming healthy.
Recovery
For build or startup failure:
slipway logs --deployment DEPLOYMENT_IDIf the transport times out or disconnects, inspect that deployment before retrying. Upload requests have a two-minute deadline; normal API requests have a 30-second deadline. A client timeout does not cancel server work.
There is no CLI rollback or deployment-cancel command. Use the selected app's deployment history for rollback, and the dashboard's deployment controls for supported cancellation. See How Deployments Work.
For automatic deployment, use Git Integration. Review Deploy Tokens before choosing pipeline credentials; SLIPWAY_TOKEN is not implemented as CLI authentication.