[{"data":1,"prerenderedAt":280},["ShallowReactive",2],{"page-\u002Fstorage\u002Ftroubleshooting":3,"surround-\u002Fstorage\u002Ftroubleshooting":271},{"id":4,"title":5,"body":6,"description":263,"extension":264,"meta":265,"navigation":266,"path":267,"seo":268,"stem":269,"__hash__":270},"docs\u002Fstorage\u002Ftroubleshooting.md","Troubleshooting",{"type":7,"value":8,"toc":240},"minimark",[9,13,18,23,37,41,47,51,55,88,91,110,114,118,126,130,133,137,144,148,152,155,159,162,193,197,212,216,225,236],[10,11,12],"p",{},"This page lists common problems with storage, grouped by what you were doing, each with its cause and fix.",[14,15,17],"h2",{"id":16},"lost-files","Lost files",[19,20,22],"h3",{"id":21},"my-files-are-gone-after-a-stop-or-restart","My files are gone after a stop or restart",[10,24,25,26,30,31,36],{},"They were on the container disk, which is erased when an instance stops or restarts and when a Run Job ends. Only network volumes keep files. Mount one at ",[27,28,29],"code",{},"\u002Fworkspace"," for work you need to keep. See ",[32,33,35],"a",{"href":34},"\u002Fstorage#choose-where-to-keep-each-file","Choose where to keep each file",".",[19,38,40],{"id":39},"i-deleted-a-volume-by-mistake","I deleted a volume by mistake",[10,42,43,44,36],{},"Deleting a volume erases its data, and it can't be recovered. Keep a copy of data you can't recreate, for example by downloading it with ",[27,45,46],{},"featherless-cloud volume cp -r vol:\u002F\u002Fmy-data\u002Fresults .\u002Fresults",[14,48,50],{"id":49},"disk-space","Disk space",[19,52,54],{"id":53},"downloads-or-installs-fail-with-no-space-left-on-device","Downloads or installs fail with No space left on device",[56,57,58,74],"ul",{},[59,60,61,65,66,69,70,73],"li",{},[62,63,64],"strong",{},"The container disk is full:"," the terminal's welcome banner shows how much is used. Move large downloads to a network volume, for example by setting ",[27,67,68],{},"HF_HOME=\u002Fworkspace\u002Fhf"," for Hugging Face models, and install packages with ",[27,71,72],{},"pip install --no-cache-dir",". To make the container disk larger, edit the instance; the restart erases the container disk, so copy anything you need first.",[59,75,76,79,80,83,84,36],{},[62,77,78],{},"A network volume is full:"," check it with ",[27,81,82],{},"df -h \u002Fworkspace"," and increase its capacity. See ",[32,85,87],{"href":86},"#the-volume-is-full","The volume is full",[19,89,87],{"id":90},"the-volume-is-full",[10,92,93,94,102,103,105,106,36],{},"Check its usage on the ",[32,95,101],{"href":96,"rel":97,"target":100},"https:\u002F\u002Fconsole.cloud.featherless.ai\u002Fstorage",[98,99],"noopener","noreferrer","_blank","Storage page"," or with ",[27,104,82],{}," inside an instance, then increase its capacity. Running instances see the new size right away. See ",[32,107,109],{"href":108},"\u002Fstorage\u002Fnetwork-volumes#resize-a-volume","Resize a volume",[14,111,113],{"id":112},"mounting-and-deleting","Mounting and deleting",[19,115,117],{"id":116},"i-cant-add-a-volume-to-an-existing-instance","I can't add a volume to an existing instance",[10,119,120,121,125],{},"Volumes are set when you deploy and can't be added or removed afterwards, even with the instance stopped. Copy anything you need off the old instance's container disk, then deploy a new instance with the volume mounted. To deploy with the same settings, save the old instance's settings as a ",[32,122,124],{"href":123},"\u002Ftemplates\u002Fmanage","template"," first.",[19,127,129],{"id":128},"two-jobs-overwrote-each-others-results","Two jobs overwrote each other's results",[10,131,132],{},"Several instances and Run Jobs can write to one volume at once, and nothing stops two of them writing the same file. Give each its own output folder, for example by including the job's name in the path.",[19,134,136],{"id":135},"a-volume-cant-be-deleted","A volume can't be deleted",[10,138,139,140,143],{},"Instances still mount it. Stop them first, then use ",[62,141,142],{},"Detach and delete",", which removes the volume from them before deleting it.",[14,145,147],{"id":146},"uploads-and-downloads","Uploads and downloads",[19,149,151],{"id":150},"an-upload-fails-right-after-creating-a-volume","An upload fails right after creating a volume",[10,153,154],{},"A new volume takes about a minute to be ready for files. Wait, then upload again.",[19,156,158],{"id":157},"a-file-over-64-gib-wont-upload-in-the-console","A file over 64 GiB won't upload in the console",[10,160,161],{},"The console uploads files up to 64 GiB. Use the CLI for larger files:",[163,164,169],"pre",{"className":165,"code":166,"language":167,"meta":168,"style":168},"language-bash shiki shiki-themes github-dark-default","featherless-cloud volume cp .\u002Fmodel.safetensors vol:\u002F\u002Fmy-data\u002Fmodels\u002F\n","bash","",[27,170,171],{"__ignoreMap":168},[172,173,176,180,184,187,190],"span",{"class":174,"line":175},"line",1,[172,177,179],{"class":178},"sQhOw","featherless-cloud",[172,181,183],{"class":182},"s9uIt"," volume",[172,185,186],{"class":182}," cp",[172,188,189],{"class":182}," .\u002Fmodel.safetensors",[172,191,192],{"class":182}," vol:\u002F\u002Fmy-data\u002Fmodels\u002F\n",[19,194,196],{"id":195},"a-large-copy-was-interrupted","A large copy was interrupted",[10,198,199,200,203,204,207,208,211],{},"Run the same ",[27,201,202],{},"volume cp"," or ",[27,205,206],{},"volume sync"," command again. It resumes where it stopped; add ",[27,209,210],{},"--update"," to skip files that already match.",[14,213,215],{"id":214},"getting-help","Getting help",[10,217,218,219,224],{},"If you're still stuck, ask us on ",[32,220,223],{"href":221,"rel":222,"target":100},"https:\u002F\u002Fdiscord.com\u002Finvite\u002F7gybCMPjVA",[98,99],"Discord",". Include:",[56,226,227,230,233],{},[59,228,229],{},"the volume's name;",[59,231,232],{},"what you did, such as the command you ran, and the exact error;",[59,234,235],{},"when it happened.",[237,238,239],"style",{},"html pre.shiki code .sQhOw, html code.shiki .sQhOw{--shiki-default:#FFA657}html pre.shiki code .s9uIt, html code.shiki .s9uIt{--shiki-default:#A5D6FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":168,"searchDepth":241,"depth":241,"links":242},2,[243,248,252,257,262],{"id":16,"depth":241,"text":17,"children":244},[245,247],{"id":21,"depth":246,"text":22},3,{"id":39,"depth":246,"text":40},{"id":49,"depth":241,"text":50,"children":249},[250,251],{"id":53,"depth":246,"text":54},{"id":90,"depth":246,"text":87},{"id":112,"depth":241,"text":113,"children":253},[254,255,256],{"id":116,"depth":246,"text":117},{"id":128,"depth":246,"text":129},{"id":135,"depth":246,"text":136},{"id":146,"depth":241,"text":147,"children":258},[259,260,261],{"id":150,"depth":246,"text":151},{"id":157,"depth":246,"text":158},{"id":195,"depth":246,"text":196},{"id":214,"depth":241,"text":215},"Fix common storage problems, from full disks and failed uploads to files lost on a stop.","md",{},true,"\u002Fstorage\u002Ftroubleshooting",{"title":5,"description":263},"storage\u002Ftroubleshooting","ZAr0LaMYv03whKaC3Uou5KJaR5Do52aVop7jBs9gwMw",[272,276],{"title":273,"path":274,"description":275},"Transfer files","\u002Fstorage\u002Ftransfer-files","Move data in and out of network volumes without running an instance.",{"title":277,"path":278,"description":279},"Templates overview","\u002Ftemplates","Start from maintained environments, or save your own setup so you and your team deploy it the same way every time.",1794932598313]