Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Resolve target, manifest, and release errors without discarding workspace data.
rig --version
rig workspace ls
rig app-release ls --workspace WORKSPACE
| Error category | Recovery |
|---|---|
| Unknown field or removed build shape | Compare with the v0.13 manifest reference |
| Existing app or port owned by another deployment | Choose a new target or explicitly plan migration; do not overwrite unrelated apps |
| App requires system packages | Provision the workspace image; incremental installers are unprivileged |
| Invalid working directory | Use release-relative paths and move mutable data to a persistent volume |
| Source exceeds upload limits | Remove generated output, caches, or large assets from deployment input |
| Strategy not enabled | Verify account access and deployed server compatibility |
| Re-image requested by an image deployment | Back up root-disk data and review the image strategy before opting in |
.rig.lock unless you deliberately intend to change the deployment identity. Check the latest release before attempting activation again.
Use deployment strategies for an older project and app rollback for retained code/configuration. Neither is a substitute for a data restore.