Connect through SSH and inspect the application’s configured data path and mounts. Determine whether files were stored in a managed app release directory, the workspace root disk, or a separate volume.
Symptom
Check
Files disappear after redeploy
Application wrote mutable data beside source instead of its data mount
Database missing after re-image
Database lived on the replaced root disk
Snapshot restore did not rewind database
Database resides on an attached volume, outside the snapshot
Restored app cannot read data
Mount path, ownership, configuration, or schema is incompatible
Preserve the current disk and error evidence. Choose a retained app release for a code/configuration failure, a root-disk snapshot for a system filesystem failure, or an application backup for data loss. Check recovery boundaries first.A snapshot is not a backup of persistent volumes, and creating a new snapshot replaces the workspace’s previous checkpoint. Do not create one reflexively when trying to recover the old one.
Store mutable files on a declared persistent volume, configure an application-consistent backup, and test restoring it. Verify persistence by creating a record, redeploying, and reading the same record afterward.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Rigbox Docs","colors":{"primary":"#087f5b","light":"#4adea1","dark":"#087f5b"},"logo":{"light":"https://mintcdn.com/rigboxdev/Rogw0IXvCQYauc6t/logo/light.svg?fit=max\u0026auto=format\u0026n=Rogw0IXvCQYauc6t\u0026q=85\u0026s=ef879268a073e730ee09723ddacb98bc","dark":"https://mintcdn.com/rigboxdev/Rogw0IXvCQYauc6t/logo/dark.svg?fit=max\u0026auto=format\u0026n=Rogw0IXvCQYauc6t\u0026q=85\u0026s=f6eeababc463da0fde9dae4648e3be46"},"favicon":"https://mintcdn.com/rigboxdev/_yqT-BkvJuOZxL-6/favicon.svg?fit=max\u0026auto=format\u0026n=_yqT-BkvJuOZxL-6\u0026q=85\u0026s=fcfd7fb992153e610ed1a7aa679e9021","api":{},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#ffffff","dark":"#000000"}},"navbar":{"links":[{"href":"https://rigbox.dev","label":"Rigbox"}],"primary":{"type":"button","label":"Get started","href":"/quickstart"}},"fonts":{"family":"Geist"},"styling":{"eyebrows":"breadcrumbs","latex":false},"interaction":{"drilldown":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"rigboxdev","hasAudioNarration":false,"actualSubdomain":"rigboxdev","customDomains":["docs.rigbox.dev"],"gitSource":{"type":"github","owner":"rigbox-dev","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac2d3f73a1abb9ff163c8c3","collectionId":"aaa5748c-e559-420f-b04c-b37ff7214f71","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac2d3f73a1abb9ff163c8c3"},"entitlements":{},"buildId":"6ac2d3f73a1abb9ff163c8c3","clientVersion":"0.0.3952","searchFilterCounts":[{"language":"default","tag":"API Reference","count":117},{"language":"default","tag":"Docs","count":98},{"language":"default","tag":"Applications and releases","count":34},{"language":"default","tag":"Workspaces","count":29},{"language":"default","tag":"AI and tools","count":25},{"language":"default","tag":"Apps","count":17},{"language":"default","tag":"Deploy applications","count":17},{"language":"default","tag":"Configure applications","count":16},{"language":"default","tag":"Access","count":15},{"language":"default","tag":"Registry","count":15}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--rigbox-text:#171717;--rigbox-muted:#666666;--rigbox-border:#e5e5e5;--rigbox-surface:#fafafa;--rigbox-background:#ffffff;--rigbox-active:#f2f2f2;--rigbox-accent:#087f5b}.dark{--rigbox-text:#ededed;--rigbox-muted:#a1a1a1;--rigbox-border:#292929;--rigbox-surface:#0a0a0a;--rigbox-background:#000000;--rigbox-active:#1f1f1f;--rigbox-accent:#4adea1}#content-area{font-size:16px;line-height:1.7}#page-title{font-size:40px;font-weight:600;letter-spacing:-.04em;line-height:1.2}#content-container code,#content-container pre{font-family:'Geist Mono',monospace}#content-container pre{font-size:13px}#content .card,#content-area .code-block,#content-area pre{border-radius:6px}#content-area a:focus-visible,#sidebar a:focus-visible{outline:2px solid var(--rigbox-accent);outline-offset:3px}#content-area:has(.rigbox-home)>#header{display:none}@media (min-width:1024px){#navbar{height:calc(64px + var(--banner-height, 0px))}#navbar>.relative{max-width:none}#navbar .h-16{padding-left:24px;padding-right:24px}#navbar .h-16>div{border-bottom:0}#navbar .nav-tabs{position:fixed;top:var(--banner-height, 0px);left:174px;height:64px;gap:24px;align-items:center}#navbar div:has(>.nav-tabs){height:0;padding:0}#navbar .nav-tabs-item{height:36px;font-weight:400;font-size:14px}#navbar .nav-tabs-item>div,#sidebar-content>div>.sticky,#topbar-cta-button svg{display:none}#navbar-transition{border-bottom:0;background:var(--rigbox-background);backdrop-filter:none}#search-bar-entry{position:fixed;top:calc(76px + var(--banner-height, 0px));left:12px;width:264px;height:38px;min-width:0;border-radius:6px;background:var(--rigbox-surface)}#topbar-cta-button a{padding:7px 12px}#topbar-cta-button a>span{border-radius:6px;background:var(--rigbox-text)}#topbar-cta-button a>div>span{color:var(--rigbox-background)}div:has(>#sidebar){max-width:none!important;padding:0 0 0 300px!important}#sidebar{position:fixed!important;left:0;top:calc(64px + var(--banner-height, 0px))!important;width:288px;border:0}#sidebar-content{padding:64px 12px 32px}#sidebar #navigation-items>div{margin:0 0 28px;padding:0;border:0}#sidebar .sidebar-group-header{padding:0 8px;margin-bottom:4px}#sidebar #sidebar-title{color:var(--rigbox-text);font-size:15px;line-height:22px;font-weight:650}#sidebar #sidebar-group{margin:0}#sidebar a{padding:8px 10px!important;min-height:36px;font-size:14px;line-height:20px;font-weight:400;border:0;border-radius:6px}#sidebar a[class*=text-primary]{color:var(--rigbox-text);background:var(--rigbox-active);text-shadow:none}#content-container{width:100%;margin-left:clamp(0px,calc(25vw - 360px),96px);margin-right:auto;padding:40px 40px 0;max-width:1188px!important}#content-container:has(.rigbox-home){max-width:1152px!important}#content-container>div{padding-top:0}#content-area{margin:0;padding:0;width:auto;min-width:0}#content{margin-top:24px}#content:has(.rigbox-home){margin-top:0}}#content .rigbox-terminal [data-component-part=tab-button][data-active=true],.rigbox-home{color:var(--rigbox-text)}.rigbox-hero{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:48px;align-items:center;margin-bottom:48px}#content .rigbox-home h1{font-size:56px;font-weight:600;line-height:1;letter-spacing:-.055em;margin:0 0 28px}#content .rigbox-lead{font-size:20px;line-height:30px;color:var(--rigbox-muted);margin:0}.rigbox-actions{display:flex;flex-wrap:wrap;gap:10px;margin-top:32px}#content .rigbox-button,#content a.rigbox-feature-card{border:1px solid var(--rigbox-border);background:var(--rigbox-surface);color:var(--rigbox-text);text-decoration:none}#content .rigbox-button{display:inline-flex;justify-content:center;align-items:center;padding:8px 14px;min-height:38px;border-radius:6px;font-size:14px;line-height:20px;font-weight:500}#content .rigbox-button-primary{background:var(--rigbox-text);color:var(--rigbox-background);border-color:var(--rigbox-text)}#content .rigbox-button:hover{opacity:.85}.rigbox-terminal{min-width:0}#content .rigbox-terminal>div{margin:0}#content .rigbox-terminal pre{border-radius:0 0 6px 6px}.rigbox-section{margin-bottom:48px}#content .rigbox-section h2{font-size:28px;line-height:36px;font-weight:600;letter-spacing:-.035em;margin:0 0 12px}#content .rigbox-section>p{font-size:17px;line-height:28px;margin:0 0 20px;color:var(--rigbox-text)}.rigbox-card-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:16px}#content a.rigbox-feature-card{display:block;min-width:0;padding:24px;border-radius:8px;font-weight:400}#content a.rigbox-feature-card:hover{border-color:var(--rigbox-muted)}#content .rigbox-feature-card>svg{width:20px;height:20px;margin:0 0 20px;color:var(--rigbox-text)}#content .rigbox-feature-card .rigbox-card-title{display:block;font-size:16px;line-height:24px;font-weight:600;letter-spacing:-.02em;margin:0 0 4px}#content .rigbox-feature-card p{color:var(--rigbox-muted);font-size:14px;line-height:21px;margin:0}.rigbox-api-note{color:var(--rigbox-muted);font-size:12px;margin-top:20px;overflow-wrap:anywhere}@media (min-width:1024px) and (max-width:1250px){.rigbox-hero{gap:28px}#content .rigbox-home h1{font-size:48px}.rigbox-card-grid{grid-template-columns:repeat(2,minmax(0,1fr))}}@media (max-width:1023px){.rigbox-hero{gap:28px}#content .rigbox-home h1{font-size:44px}.rigbox-card-grid{grid-template-columns:repeat(2,minmax(0,1fr))}}@media (max-width:640px){#page-title{font-size:32px}#content .rigbox-home h1{font-size:40px}.rigbox-hero{margin-bottom:36px}.rigbox-card-grid,.rigbox-hero{grid-template-columns:1fr}#content .rigbox-lead{font-size:16px;line-height:26px}.rigbox-section{margin-bottom:36px}}#content .rigbox-terminal [data-component-part=tabs-list]{margin-bottom:16px;gap:16px}#content .rigbox-terminal [data-component-part=tab-button]{font-weight:400;color:var(--rigbox-muted)}#content .rigbox-terminal .code-block{margin:0;padding:0;background:var(--rigbox-surface)}#content .rigbox-terminal [data-component-part=code-block-header]{border-bottom:1px solid var(--rigbox-border);border-radius:6px 6px 0 0;min-height:40px}#content .rigbox-terminal [data-component-part=tab-content]{padding:0}@media (min-width:1024px) and (max-width:1400px){#content-container{padding-left:32px;padding-right:32px}}#header .eyebrow{color:var(--rigbox-muted);font-size:13px;margin-bottom:16px}#header>div>div:has(#page-title){margin-top:0}#header>div:has(>p){margin-top:16px}#header>div>p{font-size:18px;line-height:28px;margin:0}@media (min-width:1024px){#sidebar button[aria-expanded]{padding:8px 10px!important;min-height:36px;font-size:14px;line-height:20px;border-radius:6px;justify-content:space-between}#sidebar button[aria-expanded]>svg{margin-left:auto}#sidebar li li a{padding-left:16px!important}#sidebar li li li a{padding-left:24px!important}#sidebar li li li li a{padding-left:32px!important}#sidebar a:focus-visible,#sidebar button:focus-visible{outline:2px solid var(--rigbox-accent);outline-offset:-2px}#table-of-contents-layout{width:208px;padding-left:0}#table-of-contents{width:208px}#content-side-layout{top:calc(88px + var(--banner-height, 0px));height:calc(100vh - 112px - var(--banner-height, 0px))}}@media (min-width:1280px){#content-container:has(#table-of-contents,#table-of-contents-layout){max-width:1056px!important}#content-container:has(#table-of-contents,#table-of-contents-layout) #content-area{max-width:720px}}#content .rigbox-terminal-note{font-size:13px;line-height:21px;color:var(--rigbox-muted);margin-top:16px}.rigbox-card-arrow{display:block;margin-top:16px;color:var(--rigbox-accent)}#banner{background:var(--rigbox-surface);border-bottom:1px solid var(--rigbox-border)}#banner,#banner *{color:var(--rigbox-muted)!important}#sidebar #navigation-items h3,#sidebar #navigation-items h5{color:var(--rigbox-text);font-size:15px;font-weight:650;line-height:22px;letter-spacing:-.01em;margin-bottom:8px}@media (min-width:1440px){#table-of-contents{position:fixed!important;right:32px;top:calc(104px + var(--banner-height, 0px));margin-top:0;padding-top:0;width:208px;height:calc(100vh - 128px - var(--banner-height, 0px));max-height:calc(100vh - 128px - var(--banner-height, 0px));overflow-y:auto}#table-of-contents>[data-component-part=scroll-area-viewport]{padding-top:0}}"}],"page":{"pagePath":"operate/storage","slug":"/operate/storage","pageMetadata":{"title":"Troubleshoot storage and recovery","description":"Find where data was written before choosing a recovery action.","href":"/operate/storage"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Find where data was written before choosing a recovery action.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`identify-the-data-location`,children:`Identify the data location`}),`\n`,_jsx(_components.p,{children:`Connect through SSH and inspect the application’s configured data path and mounts. Determine whether files were stored in a managed app release directory, the workspace root disk, or a separate volume.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Symptom`}),_jsx(_components.th,{children:`Check`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Files disappear after redeploy`}),_jsx(_components.td,{children:`Application wrote mutable data beside source instead of its data mount`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Database missing after re-image`}),_jsx(_components.td,{children:`Database lived on the replaced root disk`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Snapshot restore did not rewind database`}),_jsx(_components.td,{children:`Database resides on an attached volume, outside the snapshot`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Restored app cannot read data`}),_jsx(_components.td,{children:`Mount path, ownership, configuration, or schema is incompatible`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Volume operation rejected`}),_jsx(_components.td,{children:`Stop the workspace before changing the drive set`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`recover-carefully`,children:`Recover carefully`}),`\n`,_jsxs(_components.p,{children:[`Preserve the current disk and error evidence. Choose a retained app release for a code/configuration failure, a root-disk snapshot for a system filesystem failure, or an application backup for data loss. Check `,_jsx(_components.a,{href:`/workspaces/recovery-limits`,children:`recovery boundaries`}),` first.`]}),`\n`,_jsx(_components.p,{children:`A snapshot is not a backup of persistent volumes, and creating a new snapshot replaces the workspace’s previous checkpoint. Do not create one reflexively when trying to recover the old one.`}),`\n`,_jsx(Heading,{level:`2`,id:`prevent-recurrence`,children:`Prevent recurrence`}),`\n`,_jsxs(_components.p,{children:[`Store mutable files on a declared `,_jsx(_components.a,{href:`/guides/persistent-volumes`,children:`persistent volume`}),`, configure an application-consistent backup, and test restoring it. Verify persistence by creating a record, redeploying, and reading the same record afterward.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Troubleshoot storage and recovery","description":"Find where data was written before choosing a recovery action.","href":"/operate/storage"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Identify the data location","slug":"identify-the-data-location","depth":2,"children":[]},{"title":"Recover carefully","slug":"recover-carefully","depth":2,"children":[]},{"title":"Prevent recurrence","slug":"prevent-recurrence","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"rigboxdev","siteName":"Rigbox Docs","title":"Troubleshoot storage and recovery - Rigbox Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-08T06:53:47.870Z","originalFileLocation":"operate/storage.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Find where data was written before choosing a recovery action.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Rigbox Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rigboxdev/hyoSsl7GFjqpia_W/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/rigboxdev/hyoSsl7GFjqpia_W/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rigboxdev/hyoSsl7GFjqpia_W/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/rigboxdev/hyoSsl7GFjqpia_W/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/rigboxdev/hyoSsl7GFjqpia_W/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rigboxdev/hyoSsl7GFjqpia_W/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rigboxdev/hyoSsl7GFjqpia_W/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/rigboxdev/hyoSsl7GFjqpia_W/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/rigboxdev/hyoSsl7GFjqpia_W/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Troubleshoot storage and recovery - Rigbox Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Find where data was written before choosing a recovery action.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Rigbox Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.rigbox.dev/operate/storage\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://rigboxdev.mintlify.app/_mintlify/api/og/v2?division=Operate+and+troubleshoot\u0026amp;title=Troubleshoot+storage+and+recovery\u0026amp;description=Find+where+data+was+written+before+choosing+a+recovery+action.\u0026amp;theme=97438133711f07306267380c\u0026amp;signature=0f79690ed31be1f88704497aee41c72dfafca6ce136caa109f8c8232b3eca33b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Troubleshoot storage and recovery - Rigbox Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Find where data was written before choosing a recovery action.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rigboxdev.mintlify.app/_mintlify/api/og/v2?division=Operate+and+troubleshoot\u0026amp;title=Troubleshoot+storage+and+recovery\u0026amp;description=Find+where+data+was+written+before+choosing+a+recovery+action.\u0026amp;theme=97438133711f07306267380c\u0026amp;signature=0f79690ed31be1f88704497aee41c72dfafca6ce136caa109f8c8232b3eca33b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/rigboxdev/hyoSsl7GFjqpia_W/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Rigbox Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#087f5b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.rigbox.dev/operate/storage\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/operate/storage.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.rigbox.dev/#organization\",\"name\":\"Rigbox Docs\",\"url\":\"https://docs.rigbox.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/rigboxdev/Rogw0IXvCQYauc6t/logo/light.svg?fit=max\u0026auto=format\u0026n=Rogw0IXvCQYauc6t\u0026q=85\u0026s=ef879268a073e730ee09723ddacb98bc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.rigbox.dev#website\",\"name\":\"Rigbox Docs\",\"url\":\"https://docs.rigbox.dev\",\"publisher\":{\"@id\":\"https://docs.rigbox.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.rigbox.dev/operate/storage#webpage\",\"url\":\"https://docs.rigbox.dev/operate/storage\",\"name\":\"Troubleshoot storage and recovery\",\"description\":\"Find where data was written before choosing a recovery action.\",\"dateModified\":\"2026-09-08T06:53:47.870Z\",\"isPartOf\":{\"@id\":\"https://docs.rigbox.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rigbox.dev/operate/storage#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rigbox.dev/operate/storage#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Operate and troubleshoot\",\"item\":\"https://docs.rigbox.dev/operate/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Troubleshoot storage and recovery\",\"item\":\"https://docs.rigbox.dev/operate/storage\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.rigbox.dev/operate/storage#article\",\"headline\":\"Troubleshoot storage and recovery\",\"name\":\"Troubleshoot storage and recovery\",\"description\":\"Find where data was written before choosing a recovery action.\",\"url\":\"https://docs.rigbox.dev/operate/storage\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rigbox.dev/operate/storage#webpage\"},\"dateModified\":\"2026-09-08T06:53:47.870Z\",\"publisher\":{\"@id\":\"https://docs.rigbox.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.rigbox.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Rigbox Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Rigbox Docs","nav":{"global":null,"tabs":[{"tab":"Docs","groups":[{"group":"Start here","pages":[{"title":"Build and run on Rigbox","sidebarTitle":"Overview","mode":"wide","href":"/introduction"},{"title":"Deploy your first app","href":"/quickstart"},{"title":"Install the CLI","href":"/guides/install-cli"},{"title":"Core concepts","href":"/concepts/core"}]},{"group":"Deploy applications","pages":[{"title":"Deploy applications","href":"/deploy/overview"},{"title":"Deploy from your machine","href":"/guides/deploying"},{"group":"GitHub","expanded":false,"pages":[{"title":"Deploy from GitHub","href":"/guides/github"},{"title":"Deploy from GitHub Actions","sidebarTitle":"GitHub Actions","href":"/guides/github-actions"},{"title":"Deploy buttons","href":"/guides/deploy-button"}]},{"group":"Multi-app projects","expanded":false,"pages":[{"title":"Multi-app projects","href":"/deploy/multi-app"},{"title":"Dependencies and service discovery","href":"/deploy/dependencies"},{"title":"Deploy one app","href":"/deploy/single-app"}]},{"title":"Development loop","href":"/deploy/development-loop"},{"title":"Stage and activate","href":"/deploy/stage-and-activate"},{"title":"Roll back app code","href":"/deploy/app-rollback"},{"title":"Release ownership","href":"/deploy/release-ownership"},{"group":"Reproducible builds","expanded":false,"pages":[{"title":"Reproducible workspace builds","href":"/deploy/reproducible-builds"},{"title":"Build and dependency caching","href":"/deploy/build-cache"},{"title":"Re-image a workspace","href":"/deploy/reimage"},{"title":"Releases \u0026 Rollback","href":"/guides/releases-and-rollback"}]},{"title":"Blue-green deploys \u0026 promotion","href":"/guides/bluegreen"}]},{"group":"Configure applications","pages":[{"title":"Configure applications","href":"/configure/overview"},{"title":"Environment variables","href":"/configure/environment"},{"title":"Secrets and generated credentials","href":"/configure/secrets"},{"title":"Validated parameters","href":"/configure/parameters"},{"title":"Install, build, and start commands","href":"/configure/commands"},{"title":"Health checks","href":"/configure/health"},{"title":"App Visibility","href":"/guides/visibility"},{"title":"Expose Ports \u0026 Route Apps","href":"/guides/expose-and-route"},{"title":"Local tunnels","href":"/guides/local-tunnels"},{"title":"Custom Domains","href":"/guides/custom-domains"},{"group":"rig.yaml","expanded":false,"pages":[{"title":"rig.yaml reference","href":"/reference/rig-yaml"},{"title":"Application fields","href":"/reference/rig-yaml/application"},{"title":"Workspace fields","href":"/reference/rig-yaml/workspace"},{"title":"Source and dependency fields","href":"/reference/rig-yaml/source"},{"title":"Configuration fields","href":"/reference/rig-yaml/configuration"},{"title":"Deployment fields","href":"/reference/rig-yaml/deployment"}]}]},{"group":"Workspaces and storage","pages":[{"title":"Workspaces and storage","href":"/workspaces/overview"},{"title":"Workspaces","href":"/guides/workspaces"},{"title":"Resource Limits \u0026 Quotas","href":"/concepts/limits"},{"group":"SSH","expanded":false,"pages":[{"title":"SSH Access","href":"/guides/ssh-access"},{"title":"Manage SSH keys","href":"/workspaces/ssh-keys"},{"title":"Transfer files","href":"/workspaces/file-transfer"}]},{"title":"Images \u0026 Templates","href":"/guides/images-and-templates"},{"group":"Persistent volumes","expanded":false,"pages":[{"title":"Persistent Volumes","href":"/guides/persistent-volumes"},{"title":"Resize and remove volumes","href":"/workspaces/volume-management"}]},{"group":"Snapshots","expanded":false,"pages":[{"title":"Create a workspace snapshot","href":"/guides/snapshots"},{"title":"Restore a workspace snapshot","href":"/workspaces/snapshot-restore"},{"title":"Recovery boundaries","href":"/workspaces/recovery-limits"}]},{"title":"Workspace Services","href":"/guides/workspace-services"},{"title":"Setup Scripts","href":"/guides/setup-scripts"},{"title":"Service Specs","href":"/guides/service-specs"}]},{"group":"AI and tools","pages":[{"title":"AI and tools","href":"/ai/overview"},{"title":"AI Coding Tools","href":"/guides/ai-coding-tools"},{"title":"Managed AI Proxy","href":"/guides/managed-proxy"},{"title":"Bring Your Own Keys","href":"/guides/byok"},{"title":"Catalog Apps","href":"/guides/catalog"},{"title":"Use Rigbox with Spawn","href":"/ai/spawn"},{"title":"Virtual Browser","href":"/guides/virtual-browser"},{"title":"Firecrawl","href":"/guides/firecrawl"},{"title":"Architecture Explorer","href":"/guides/architecture-explorer"}]},{"group":"Operate and troubleshoot","pages":[{"title":"Operate and troubleshoot","href":"/operate/overview"},{"title":"Read application logs","href":"/operate/app-logs"},{"title":"Read install, build, and release logs","href":"/operate/build-logs"},{"title":"CLI traces and telemetry","href":"/operate/telemetry"},{"title":"Troubleshoot health checks","href":"/operate/health"},{"title":"Troubleshoot deployments","href":"/operate/deployment"},{"title":"Troubleshoot GitHub deployments","href":"/operate/github"},{"title":"Troubleshoot SSH access","href":"/operate/ssh"},{"title":"Troubleshoot resource limits","description":"Distinguish capacity, workspace sizing, and disk usage.","href":"/operate/resources"},{"title":"Troubleshoot storage and recovery","href":"/operate/storage"}]},{"group":"Examples","pages":[{"title":"Runnable examples","description":"Learn one Rigbox capability at a time with a complete application.","href":"/examples/overview"},{"title":"Deploy your first app","href":"/examples/first-app"},{"title":"Deploy a frontend and API","href":"/examples/frontend-api"},{"title":"Build an AI chat app","href":"/examples/ai-chat"},{"title":"Receive signed webhooks","href":"/examples/webhook"},{"title":"Run a background worker","href":"/examples/background-worker"},{"title":"Keep data across app releases","href":"/examples/persistent-notes"},{"title":"Validate application configuration","href":"/examples/parameters"},{"title":"Stage a blog with blue-green deployment","href":"/examples/bluegreen"},{"title":"Install self-hosted applications","href":"/examples/self-hosted"},{"title":"Catalog agents and services","href":"/examples/catalog"}]},{"group":"CLI reference","pages":[{"title":"CLI reference","sidebarTitle":"Overview","href":"/cli-reference/cli"},{"title":"Authentication","href":"/cli-reference/authentication"},{"title":"Using the CLI","href":"/guides/using-cli"},{"title":"Configuration and output","sidebarTitle":"Configuration and output","href":"/cli-reference/configuration"},{"title":"Local versus workspace CLI","sidebarTitle":"Local versus workspace CLI","href":"/cli-reference/execution-modes"}]},{"group":"Build on Rigbox","pages":[{"title":"Build on Rigbox","href":"/build/overview"},{"title":"Make your first API request","href":"/build/quickstart"},{"title":"Manage workspace lifecycles","href":"/build/workspace-lifecycle"},{"title":"Deploy and monitor applications","href":"/build/deploy-monitor"},{"title":"Build a hosting platform","href":"/guides/build-hosting-platform"},{"title":"API conventions","href":"/build/api-conventions"},{"title":"Architecture","href":"/concepts/architecture"},{"title":"Security boundaries","href":"/concepts/security"},{"title":"Sandbox API Surface","href":"/sandbox-api-surface"},{"title":"Clawd API Surface","href":"/clawd-api-surface"},{"title":"Clawd Runtime Services","href":"/clawd-runtime-services"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]}]},"title":"Troubleshoot storage and recovery - Rigbox Docs","buildId":"dpl_7GUK3ixdQTF3BSNUQYJm8ibGxQWw","deploymentId":"dpl_7GUK3ixdQTF3BSNUQYJm8ibGxQWw","dynamics":[],"chunks":[]}