[{"data":1,"prerenderedAt":370},["ShallowReactive",2],{"page-\u002Fstorage\u002Fnetwork-volumes":3,"surround-\u002Fstorage\u002Fnetwork-volumes":364},{"id":4,"title":5,"body":6,"description":356,"extension":357,"meta":358,"navigation":359,"path":360,"seo":361,"stem":362,"__hash__":363},"docs\u002Fstorage\u002Fnetwork-volumes.md","Network volumes",{"type":7,"value":8,"toc":348},"minimark",[9,13,22,27,110,113,117,120,201,223,226,230,237,253,260,264,271,292,296,303,320,324,344],[10,11,12],"p",{},"This page shows how to create a network volume, mount it, check how much of it is used, resize it and delete it.",[10,14,15,16,21],{},"A network volume is persistent storage that lives outside any instance. Its data stays when instances stop or are deleted, and several instances and Run Jobs can mount it at once. See ",[17,18,20],"a",{"href":19},"\u002Fstorage","Storage"," to compare it with the container disk.",[23,24,26],"h2",{"id":25},"create-a-volume","Create a volume",[28,29,31,68],"tabs",{"sync":30},"interface",[32,33,35,55],"tabs-item",{"label":34},"Console",[10,36,37,38,46,47,51,52,54],{},"On the ",[17,39,45],{"href":40,"rel":41,"target":44},"https:\u002F\u002Fconsole.cloud.featherless.ai\u002Fstorage",[42,43],"noopener","noreferrer","_blank","Storage page",", click ",[48,49,50],"strong",{},"Create volume",", enter a name and a capacity, and click ",[48,53,50],{},".",[10,56,57,58,46,60,63,64,67],{},"You can also create one while you deploy an instance: under ",[48,59,5],{},[48,61,62],{},"Add network volume"," and choose ",[48,65,66],{},"New network volume…"," in the list.",[32,69,71],{"label":70},"CLI",[72,73,78],"pre",{"className":74,"code":75,"language":76,"meta":77,"style":77},"language-bash shiki shiki-themes github-dark-default","featherless-cloud volume create my-data --gb 500 --wait\n","bash","",[79,80,81],"code",{"__ignoreMap":77},[82,83,86,90,94,97,100,104,107],"span",{"class":84,"line":85},"line",1,[82,87,89],{"class":88},"sQhOw","featherless-cloud",[82,91,93],{"class":92},"s9uIt"," volume",[82,95,96],{"class":92}," create",[82,98,99],{"class":92}," my-data",[82,101,103],{"class":102},"sFSAA"," --gb",[82,105,106],{"class":102}," 500",[82,108,109],{"class":102}," --wait\n",[10,111,112],{},"A volume is billed for its full capacity whether or not you use it, so start with what you need. A new volume takes about a minute to be ready for files.",[23,114,116],{"id":115},"mount-a-volume","Mount a volume",[10,118,119],{},"Mount volumes when you deploy an instance or submit a Run Job. They can't be added to or removed from an existing instance.",[28,121,122,135],{"sync":30},[32,123,124],{"label":34},[10,125,126,127,46,129,131,132,54],{},"On the deploy page, under ",[48,128,5],{},[48,130,62],{},", choose the volume and enter the path to mount it at. The default is ",[79,133,134],{},"\u002Fworkspace",[32,136,137],{"label":70},[72,138,140],{"className":74,"code":139,"language":76,"meta":77,"style":77},"featherless-cloud instance create --name dev --template featherless\u002Frocm-pytorch --gpu-count 1 --volume my-data:\u002Fworkspace\nfeatherless-cloud exec --gpu-count 1 --volume my-data:\u002Fworkspace -- python \u002Fworkspace\u002Ftrain.py\n",[79,141,142,175],{"__ignoreMap":77},[82,143,144,146,149,151,154,157,160,163,166,169,172],{"class":84,"line":85},[82,145,89],{"class":88},[82,147,148],{"class":92}," instance",[82,150,96],{"class":92},[82,152,153],{"class":102}," --name",[82,155,156],{"class":92}," dev",[82,158,159],{"class":102}," --template",[82,161,162],{"class":92}," featherless\u002Frocm-pytorch",[82,164,165],{"class":102}," --gpu-count",[82,167,168],{"class":102}," 1",[82,170,171],{"class":102}," --volume",[82,173,174],{"class":92}," my-data:\u002Fworkspace\n",[82,176,178,180,183,185,187,189,192,195,198],{"class":84,"line":177},2,[82,179,89],{"class":88},[82,181,182],{"class":92}," exec",[82,184,165],{"class":102},[82,186,168],{"class":102},[82,188,171],{"class":102},[82,190,191],{"class":92}," my-data:\u002Fworkspace",[82,193,194],{"class":102}," --",[82,196,197],{"class":92}," python",[82,199,200],{"class":92}," \u002Fworkspace\u002Ftrain.py\n",[202,203,204,213],"ul",{},[205,206,207,212],"li",{},[48,208,209,210],{},"Mount at ",[79,211,134],{}," to keep your whole working directory across stops.",[205,214,215,222],{},[48,216,217,218,221],{},"Mount at another path, such as ",[79,219,220],{},"\u002Fdata",","," to keep datasets and models while scratch work stays on the container disk.",[10,224,225],{},"An instance or Run Job that mounts a volume runs in the volume's location. Several of them can mount the same volume; give each its own output folder so two never write the same file at once.",[23,227,229],{"id":228},"check-how-much-space-is-used","Check how much space is used",[10,231,232,233,236],{},"The ",[17,234,45],{"href":40,"rel":235,"target":44},[42,43]," shows each volume's usage and the instances that mount it. Inside an instance:",[72,238,240],{"className":74,"code":239,"language":76,"meta":77,"style":77},"df -h \u002Fworkspace\n",[79,241,242],{"__ignoreMap":77},[82,243,244,247,250],{"class":84,"line":85},[82,245,246],{"class":88},"df",[82,248,249],{"class":102}," -h",[82,251,252],{"class":92}," \u002Fworkspace\n",[10,254,255,256,259],{},"From the CLI, ",[79,257,258],{},"featherless-cloud volume get my-data"," prints the capacity, the usage and the instances using it.",[23,261,263],{"id":262},"resize-a-volume","Resize a volume",[10,265,266,267,270],{},"You can increase a volume's capacity at any time, even while it's mounted, and running instances see the new size right away. You can't decrease it. Use ",[48,268,269],{},"Edit volume"," in the volume's actions menu on the Storage page, or:",[72,272,274],{"className":74,"code":273,"language":76,"meta":77,"style":77},"featherless-cloud volume update my-data --gb 1000\n",[79,275,276],{"__ignoreMap":77},[82,277,278,280,282,285,287,289],{"class":84,"line":85},[82,279,89],{"class":88},[82,281,93],{"class":92},[82,283,284],{"class":92}," update",[82,286,99],{"class":92},[82,288,103],{"class":102},[82,290,291],{"class":102}," 1000\n",[23,293,295],{"id":294},"delete-a-volume","Delete a volume",[10,297,298,299,302],{},"Deleting a volume erases its data, and it can't be undone. If instances mount it, stop them first: ",[48,300,301],{},"Detach and delete"," removes the volume from them, and they start again without it.",[72,304,306],{"className":74,"code":305,"language":76,"meta":77,"style":77},"featherless-cloud volume delete my-data\n",[79,307,308],{"__ignoreMap":77},[82,309,310,312,314,317],{"class":84,"line":85},[82,311,89],{"class":88},[82,313,93],{"class":92},[82,315,316],{"class":92}," delete",[82,318,319],{"class":92}," my-data\n",[23,321,323],{"id":322},"next-steps","Next steps",[325,326,327,336],"card-group",{},[328,329,333],"card",{"icon":330,"title":331,"to":332},"i-lucide-folder-up","Transfer files","\u002Fstorage\u002Ftransfer-files",[10,334,335],{},"Upload and download files.",[328,337,341],{"icon":338,"title":339,"to":340},"i-lucide-notebook-pen","Develop in JupyterLab","\u002Fexamples\u002Fjupyterlab",[10,342,343],{},"Keep notebooks on a network volume.",[345,346,347],"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 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":77,"searchDepth":177,"depth":177,"links":349},[350,351,352,353,354,355],{"id":25,"depth":177,"text":26},{"id":115,"depth":177,"text":116},{"id":228,"depth":177,"text":229},{"id":262,"depth":177,"text":263},{"id":294,"depth":177,"text":295},{"id":322,"depth":177,"text":323},"Persistent, shareable storage for datasets, models and checkpoints.","md",{},true,"\u002Fstorage\u002Fnetwork-volumes",{"title":5,"description":356},"storage\u002Fnetwork-volumes","OS4fnA2TwsE7AJifjD5tvmRN8rkPI8QjxFGIBa56K48",[365,368],{"title":366,"path":19,"description":367},"Storage overview","Keep datasets, models and checkpoints safe across instances and Run Jobs.",{"title":331,"path":332,"description":369},"Move data in and out of network volumes without running an instance.",1794932598310]