[{"data":1,"prerenderedAt":434},["ShallowReactive",2],{"page-\u002Fstorage\u002Ftransfer-files":3,"surround-\u002Fstorage\u002Ftransfer-files":427},{"id":4,"title":5,"body":6,"description":420,"extension":421,"meta":422,"navigation":99,"path":423,"seo":424,"stem":425,"__hash__":426},"docs\u002Fstorage\u002Ftransfer-files.md","Transfer files",{"type":7,"value":8,"toc":409},"minimark",[9,13,18,36,40,47,52,150,161,165,171,216,234,238,291,297,301,350,360,364,382,386,405],[10,11,12],"p",{},"This page covers the console's file browser, the CLI's file commands, and copying files from inside an instance.",[14,15,17],"h2",{"id":16},"upload-and-download-in-the-console","Upload and download in the console",[10,19,20,21,30,31,35],{},"Each volume's page on the ",[22,23,29],"a",{"href":24,"rel":25,"target":28},"https:\u002F\u002Fconsole.cloud.featherless.ai\u002Fstorage",[26,27],"noopener","noreferrer","_blank","Storage page"," has a file browser for uploading, downloading, renaming and deleting files and folders. Uploads are limited to 64 GiB per file. It can't move files between folders; use ",[32,33,34],"code",{},"volume mv"," in the CLI for that.",[14,37,39],{"id":38},"move-files-with-the-cli","Move files with the CLI",[10,41,42,43,46],{},"The CLI addresses files in a volume as ",[32,44,45],{},"vol:\u002F\u002F\u003Cvolume>\u002F\u003Cpath>",". Every other path is on your computer.",[48,49,51],"h3",{"id":50},"copy-files","Copy files",[53,54,59],"pre",{"className":55,"code":56,"language":57,"meta":58,"style":58},"language-bash shiki shiki-themes github-dark-default","# Upload a folder\nfeatherless-cloud volume cp -r .\u002Fweights vol:\u002F\u002Fmy-data\u002Fmodels\u002F\n\n# Download a file\nfeatherless-cloud volume cp vol:\u002F\u002Fmy-data\u002Fmodels\u002Fout.bin .\n\n# Copy between volumes\nfeatherless-cloud volume cp -r vol:\u002F\u002Fmy-data\u002Fmodels vol:\u002F\u002Farchive\u002F\n","bash","",[32,60,61,70,94,101,107,122,127,133],{"__ignoreMap":58},[62,63,66],"span",{"class":64,"line":65},"line",1,[62,67,69],{"class":68},"sH3jZ","# Upload a folder\n",[62,71,73,77,81,84,88,91],{"class":64,"line":72},2,[62,74,76],{"class":75},"sQhOw","featherless-cloud",[62,78,80],{"class":79},"s9uIt"," volume",[62,82,83],{"class":79}," cp",[62,85,87],{"class":86},"sFSAA"," -r",[62,89,90],{"class":79}," .\u002Fweights",[62,92,93],{"class":79}," vol:\u002F\u002Fmy-data\u002Fmodels\u002F\n",[62,95,97],{"class":64,"line":96},3,[62,98,100],{"emptyLinePlaceholder":99},true,"\n",[62,102,104],{"class":64,"line":103},4,[62,105,106],{"class":68},"# Download a file\n",[62,108,110,112,114,116,119],{"class":64,"line":109},5,[62,111,76],{"class":75},[62,113,80],{"class":79},[62,115,83],{"class":79},[62,117,118],{"class":79}," vol:\u002F\u002Fmy-data\u002Fmodels\u002Fout.bin",[62,120,121],{"class":79}," .\n",[62,123,125],{"class":64,"line":124},6,[62,126,100],{"emptyLinePlaceholder":99},[62,128,130],{"class":64,"line":129},7,[62,131,132],{"class":68},"# Copy between volumes\n",[62,134,136,138,140,142,144,147],{"class":64,"line":135},8,[62,137,76],{"class":75},[62,139,80],{"class":79},[62,141,83],{"class":79},[62,143,87],{"class":86},[62,145,146],{"class":79}," vol:\u002F\u002Fmy-data\u002Fmodels",[62,148,149],{"class":79}," vol:\u002F\u002Farchive\u002F\n",[10,151,152,153,156,157,160],{},"Interrupted copies resume when you run the same command again. Add ",[32,154,155],{},"--update"," to skip files that already match, and ",[32,158,159],{},"--progress"," to show a running total.",[48,162,164],{"id":163},"sync-a-folder","Sync a folder",[10,166,167,170],{},[32,168,169],{},"sync"," sends what changed in either direction and never deletes:",[53,172,174],{"className":55,"code":173,"language":57,"meta":58,"style":58},"featherless-cloud volume sync --mkdirs .\u002Fcheckpoints vol:\u002F\u002Fmy-data\u002Fcheckpoints\nfeatherless-cloud volume sync --mode download --mkdirs .\u002Fresults vol:\u002F\u002Fmy-data\u002Fresults\n",[32,175,176,194],{"__ignoreMap":58},[62,177,178,180,182,185,188,191],{"class":64,"line":65},[62,179,76],{"class":75},[62,181,80],{"class":79},[62,183,184],{"class":79}," sync",[62,186,187],{"class":86}," --mkdirs",[62,189,190],{"class":79}," .\u002Fcheckpoints",[62,192,193],{"class":79}," vol:\u002F\u002Fmy-data\u002Fcheckpoints\n",[62,195,196,198,200,202,205,208,210,213],{"class":64,"line":72},[62,197,76],{"class":75},[62,199,80],{"class":79},[62,201,184],{"class":79},[62,203,204],{"class":86}," --mode",[62,206,207],{"class":79}," download",[62,209,187],{"class":86},[62,211,212],{"class":79}," .\u002Fresults",[62,214,215],{"class":79}," vol:\u002F\u002Fmy-data\u002Fresults\n",[10,217,218,221,222,225,226,229,230,233],{},[32,219,220],{},"--mkdirs"," creates the folder on the other side if it doesn't exist yet. Preview with ",[32,223,224],{},"--dry-run",". Limit it with ",[32,227,228],{},"--include"," and ",[32,231,232],{},"--exclude"," globs.",[48,235,237],{"id":236},"find-files","Find files",[53,239,241],{"className":55,"code":240,"language":57,"meta":58,"style":58},"featherless-cloud volume ls\nfeatherless-cloud volume ls -h vol:\u002F\u002Fmy-data\u002Fmodels\nfeatherless-cloud volume find vol:\u002F\u002Fmy-data --name \"*.safetensors\" --size +1G\n",[32,242,243,252,267],{"__ignoreMap":58},[62,244,245,247,249],{"class":64,"line":65},[62,246,76],{"class":75},[62,248,80],{"class":79},[62,250,251],{"class":79}," ls\n",[62,253,254,256,258,261,264],{"class":64,"line":72},[62,255,76],{"class":75},[62,257,80],{"class":79},[62,259,260],{"class":79}," ls",[62,262,263],{"class":86}," -h",[62,265,266],{"class":79}," vol:\u002F\u002Fmy-data\u002Fmodels\n",[62,268,269,271,273,276,279,282,285,288],{"class":64,"line":96},[62,270,76],{"class":75},[62,272,80],{"class":79},[62,274,275],{"class":79}," find",[62,277,278],{"class":79}," vol:\u002F\u002Fmy-data",[62,280,281],{"class":86}," --name",[62,283,284],{"class":79}," \"*.safetensors\"",[62,286,287],{"class":86}," --size",[62,289,290],{"class":79}," +1G\n",[10,292,293,296],{},[32,294,295],{},"volume ls"," with no path lists your volumes.",[48,298,300],{"id":299},"move-rename-and-delete-files","Move, rename and delete files",[53,302,304],{"className":55,"code":303,"language":57,"meta":58,"style":58},"featherless-cloud volume mkdir -p vol:\u002F\u002Fmy-data\u002Fruns\u002F2026-11\nfeatherless-cloud volume mv vol:\u002F\u002Fmy-data\u002Fout.bin vol:\u002F\u002Fmy-data\u002Fruns\u002F2026-11\u002F\nfeatherless-cloud volume rm -r vol:\u002F\u002Fmy-data\u002Ftmp\n",[32,305,306,321,336],{"__ignoreMap":58},[62,307,308,310,312,315,318],{"class":64,"line":65},[62,309,76],{"class":75},[62,311,80],{"class":79},[62,313,314],{"class":79}," mkdir",[62,316,317],{"class":86}," -p",[62,319,320],{"class":79}," vol:\u002F\u002Fmy-data\u002Fruns\u002F2026-11\n",[62,322,323,325,327,330,333],{"class":64,"line":72},[62,324,76],{"class":75},[62,326,80],{"class":79},[62,328,329],{"class":79}," mv",[62,331,332],{"class":79}," vol:\u002F\u002Fmy-data\u002Fout.bin",[62,334,335],{"class":79}," vol:\u002F\u002Fmy-data\u002Fruns\u002F2026-11\u002F\n",[62,337,338,340,342,345,347],{"class":64,"line":96},[62,339,76],{"class":75},[62,341,80],{"class":79},[62,343,344],{"class":79}," rm",[62,346,87],{"class":86},[62,348,349],{"class":79}," vol:\u002F\u002Fmy-data\u002Ftmp\n",[10,351,352,353,359],{},"See ",[22,354,356],{"href":355},"\u002Fcli\u002Fvolume",[32,357,358],{},"volume"," for every option.",[14,361,363],{"id":362},"copy-files-from-inside-an-instance","Copy files from inside an instance",[10,365,366,367,370,371,374,375,378,379,381],{},"A mounted volume is an ordinary folder in the instance. Use ",[32,368,369],{},"cp",", ",[32,372,373],{},"rsync"," or any other tool on its mount path. To copy files between your computer and a running instance over SSH, use ",[32,376,377],{},"scp"," or ",[32,380,373],{}," with the instance's SSH command.",[14,383,385],{"id":384},"next-steps","Next steps",[387,388,389,397],"card-group",{},[390,391,394],"card",{"icon":392,"title":393,"to":355},"i-lucide-terminal","volume command",[10,395,396],{},"Every file and volume command.",[390,398,402],{"icon":399,"title":400,"to":401},"i-lucide-database","Network volumes","\u002Fstorage\u002Fnetwork-volumes",[10,403,404],{},"Create, mount and resize volumes.",[406,407,408],"style",{},"html pre.shiki code .sH3jZ, html code.shiki .sH3jZ{--shiki-default:#8B949E}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 pre.shiki code .sFSAA, html code.shiki .sFSAA{--shiki-default:#79C0FF}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":58,"searchDepth":72,"depth":72,"links":410},[411,412,418,419],{"id":16,"depth":72,"text":17},{"id":38,"depth":72,"text":39,"children":413},[414,415,416,417],{"id":50,"depth":96,"text":51},{"id":163,"depth":96,"text":164},{"id":236,"depth":96,"text":237},{"id":299,"depth":96,"text":300},{"id":362,"depth":72,"text":363},{"id":384,"depth":72,"text":385},"Move data in and out of network volumes without running an instance.","md",{},"\u002Fstorage\u002Ftransfer-files",{"title":5,"description":420},"storage\u002Ftransfer-files","PVWx54DOX2DYRR7l1J4Nu_MUgYsVoBSNQrnkDtL2yhk",[428,430],{"title":400,"path":401,"description":429},"Persistent, shareable storage for datasets, models and checkpoints.",{"title":431,"path":432,"description":433},"Storage troubleshooting","\u002Fstorage\u002Ftroubleshooting","Fix common storage problems, from full disks and failed uploads to files lost on a stop.",1794932598311]