[{"data":1,"prerenderedAt":1171},["ShallowReactive",2],{"page-\u002Fcli\u002Fvolume":3,"surround-\u002Fcli\u002Fvolume":1162},{"id":4,"title":5,"body":6,"description":1154,"extension":1155,"meta":1156,"navigation":1157,"path":1158,"seo":1159,"stem":1160,"__hash__":1161},"docs\u002Fcli\u002Fvolume.md","volume",{"type":7,"value":8,"toc":1141},"minimark",[9,17,56,63,68,95,135,139,156,159,163,201,232,236,252,255,277,281,327,334,387,391,448,615,619,671,681,767,771,791,838,842,899,918,1023,1027,1047,1072,1076,1106,1137],[10,11,12,13,16],"p",{},"The ",[14,15,5],"code",{}," commands create, resize and delete network volumes, and copy, sync, find and organize the files in them.",[18,19,24],"pre",{"className":20,"code":21,"language":22,"meta":23,"style":23},"language-bash shiki shiki-themes github-dark-default","featherless-cloud volume \u003Csubcommand> [options]\n","bash","",[14,25,26],{"__ignoreMap":23},[27,28,31,35,39,43,46,50,53],"span",{"class":29,"line":30},"line",1,[27,32,34],{"class":33},"sQhOw","featherless-cloud",[27,36,38],{"class":37},"s9uIt"," volume",[27,40,42],{"class":41},"suJrU"," \u003C",[27,44,45],{"class":37},"subcomman",[27,47,49],{"class":48},"sZEs4","d",[27,51,52],{"class":41},">",[27,54,55],{"class":48}," [options]\n",[10,57,58,59,62],{},"Files in a volume are written ",[14,60,61],{},"vol:\u002F\u002F\u003Cvolume>\u002F\u003Cpath>",". Every other path is on your computer.",[64,65,67],"h2",{"id":66},"create-a-volume","Create a volume",[18,69,71],{"className":20,"code":70,"language":22,"meta":23,"style":23},"featherless-cloud volume create datasets --gb 500 --wait\n",[14,72,73],{"__ignoreMap":23},[27,74,75,77,79,82,85,89,92],{"class":29,"line":30},[27,76,34],{"class":33},[27,78,38],{"class":37},[27,80,81],{"class":37}," create",[27,83,84],{"class":37}," datasets",[27,86,88],{"class":87},"sFSAA"," --gb",[27,90,91],{"class":87}," 500",[27,93,94],{"class":87}," --wait\n",[96,97,98,111],"table",{},[99,100,101],"thead",{},[102,103,104,108],"tr",{},[105,106,107],"th",{},"Option",[105,109,110],{},"Description",[112,113,114,125],"tbody",{},[102,115,116,122],{},[117,118,119],"td",{},[14,120,121],{},"--gb \u003Cn>",[117,123,124],{},"Capacity, 10–10,240. Default 100.",[102,126,127,132],{},[117,128,129],{},[14,130,131],{},"--wait",[117,133,134],{},"Wait up to about 30 seconds for the volume to become usable.",[64,136,138],{"id":137},"show-a-volume","Show a volume",[18,140,142],{"className":20,"code":141,"language":22,"meta":23,"style":23},"featherless-cloud volume get datasets\n",[14,143,144],{"__ignoreMap":23},[27,145,146,148,150,153],{"class":29,"line":30},[27,147,34],{"class":33},[27,149,38],{"class":37},[27,151,152],{"class":37}," get",[27,154,155],{"class":37}," datasets\n",[10,157,158],{},"Prints its status, capacity, usage, price and the instances using it.",[64,160,162],{"id":161},"change-a-volume","Change a volume",[18,164,166],{"className":20,"code":165,"language":22,"meta":23,"style":23},"featherless-cloud volume update datasets --gb 1000\nfeatherless-cloud volume update datasets --name training-data\n",[14,167,168,184],{"__ignoreMap":23},[27,169,170,172,174,177,179,181],{"class":29,"line":30},[27,171,34],{"class":33},[27,173,38],{"class":37},[27,175,176],{"class":37}," update",[27,178,84],{"class":37},[27,180,88],{"class":87},[27,182,183],{"class":87}," 1000\n",[27,185,187,189,191,193,195,198],{"class":29,"line":186},2,[27,188,34],{"class":33},[27,190,38],{"class":37},[27,192,176],{"class":37},[27,194,84],{"class":37},[27,196,197],{"class":87}," --name",[27,199,200],{"class":37}," training-data\n",[96,202,203,211],{},[99,204,205],{},[102,206,207,209],{},[105,208,107],{},[105,210,110],{},[112,212,213,223],{},[102,214,215,220],{},[117,216,217],{},[14,218,219],{},"--name \u003Cname>",[117,221,222],{},"New name.",[102,224,225,229],{},[117,226,227],{},[14,228,121],{},[117,230,231],{},"New capacity. It can only grow.",[64,233,235],{"id":234},"delete-a-volume","Delete a volume",[18,237,239],{"className":20,"code":238,"language":22,"meta":23,"style":23},"featherless-cloud volume delete datasets\n",[14,240,241],{"__ignoreMap":23},[27,242,243,245,247,250],{"class":29,"line":30},[27,244,34],{"class":33},[27,246,38],{"class":37},[27,248,249],{"class":37}," delete",[27,251,155],{"class":37},[10,253,254],{},"Deletes the volume and all its files. Instances using it must be stopped first.",[96,256,257,265],{},[99,258,259],{},[102,260,261,263],{},[105,262,107],{},[105,264,110],{},[112,266,267],{},[102,268,269,274],{},[117,270,271],{},[14,272,273],{},"--yes",[117,275,276],{},"Skip the confirmation.",[64,278,280],{"id":279},"list-files","List files",[18,282,284],{"className":20,"code":283,"language":22,"meta":23,"style":23},"featherless-cloud volume ls\nfeatherless-cloud volume ls -h vol:\u002F\u002Fdatasets\u002Ftrain\nfeatherless-cloud volume ls -r --summarize vol:\u002F\u002Fdatasets\u002Ftrain\n",[14,285,286,295,310],{"__ignoreMap":23},[27,287,288,290,292],{"class":29,"line":30},[27,289,34],{"class":33},[27,291,38],{"class":37},[27,293,294],{"class":37}," ls\n",[27,296,297,299,301,304,307],{"class":29,"line":186},[27,298,34],{"class":33},[27,300,38],{"class":37},[27,302,303],{"class":37}," ls",[27,305,306],{"class":87}," -h",[27,308,309],{"class":37}," vol:\u002F\u002Fdatasets\u002Ftrain\n",[27,311,313,315,317,319,322,325],{"class":29,"line":312},3,[27,314,34],{"class":33},[27,316,38],{"class":37},[27,318,303],{"class":37},[27,320,321],{"class":87}," -r",[27,323,324],{"class":87}," --summarize",[27,326,309],{"class":37},[10,328,329,330,333],{},"With no path, ",[14,331,332],{},"ls"," lists your volumes.",[96,335,336,344],{},[99,337,338],{},[102,339,340,342],{},[105,341,107],{},[105,343,110],{},[112,345,346,364,377],{},[102,347,348,357],{},[117,349,350,353,354],{},[14,351,352],{},"-h",", ",[14,355,356],{},"--human-readable",[117,358,359,360,363],{},"Sizes like ",[14,361,362],{},"1.5 KiB"," instead of bytes.",[102,365,366,374],{},[117,367,368,353,371],{},[14,369,370],{},"-r",[14,372,373],{},"--recursive",[117,375,376],{},"Everything below the folder.",[102,378,379,384],{},[117,380,381],{},[14,382,383],{},"--summarize",[117,385,386],{},"End with the number of files and their total size.",[64,388,390],{"id":389},"find-files","Find files",[18,392,394],{"className":20,"code":393,"language":22,"meta":23,"style":23},"featherless-cloud volume find vol:\u002F\u002Fdatasets --name \"*.safetensors\" --size +1G -l -h\nfeatherless-cloud volume find vol:\u002F\u002Fdatasets\u002Ftmp --type f --older-than 30d\n",[14,395,396,425],{"__ignoreMap":23},[27,397,398,400,402,405,408,410,413,416,419,422],{"class":29,"line":30},[27,399,34],{"class":33},[27,401,38],{"class":37},[27,403,404],{"class":37}," find",[27,406,407],{"class":37}," vol:\u002F\u002Fdatasets",[27,409,197],{"class":87},[27,411,412],{"class":37}," \"*.safetensors\"",[27,414,415],{"class":87}," --size",[27,417,418],{"class":37}," +1G",[27,420,421],{"class":87}," -l",[27,423,424],{"class":87}," -h\n",[27,426,427,429,431,433,436,439,442,445],{"class":29,"line":186},[27,428,34],{"class":33},[27,430,38],{"class":37},[27,432,404],{"class":37},[27,434,435],{"class":37}," vol:\u002F\u002Fdatasets\u002Ftmp",[27,437,438],{"class":87}," --type",[27,440,441],{"class":37}," f",[27,443,444],{"class":87}," --older-than",[27,446,447],{"class":37}," 30d\n",[96,449,450,458],{},[99,451,452],{},[102,453,454,456],{},[105,455,107],{},[105,457,110],{},[112,459,460,482,496,506,516,542,562,572,585,599],{},[102,461,462,467],{},[117,463,464],{},[14,465,466],{},"--name \u003Cpattern>",[117,468,469,470,473,474,477,478,481],{},"Names matching a pattern: ",[14,471,472],{},"*"," any characters, ",[14,475,476],{},"?"," one, ",[14,479,480],{},"[abc]"," one of those.",[102,483,484,489],{},[117,485,486],{},[14,487,488],{},"--iname \u003Cpattern>",[117,490,491,492,495],{},"Like ",[14,493,494],{},"--name",", ignoring case.",[102,497,498,503],{},[117,499,500],{},[14,501,502],{},"--type \u003Cf|d>",[117,504,505],{},"Only files or only folders.",[102,507,508,513],{},[117,509,510],{},[14,511,512],{},"--maxdepth \u003Cn>",[117,514,515],{},"How many levels below the folder to look.",[102,517,518,523],{},[117,519,520],{},[14,521,522],{},"--size \u003C+n|-n>",[117,524,525,526,529,530,533,534,537,538,541],{},"Bigger (",[14,527,528],{},"+",") or smaller (",[14,531,532],{},"-",") than a size like ",[14,535,536],{},"10G"," or ",[14,539,540],{},"512K",". Repeat for a range.",[102,543,544,549],{},[117,545,546],{},[14,547,548],{},"--newer-than \u003Cage>",[117,550,551,552,353,555,537,558,561],{},"Modified within an age like ",[14,553,554],{},"30m",[14,556,557],{},"12h",[14,559,560],{},"7d",".",[102,563,564,569],{},[117,565,566],{},[14,567,568],{},"--older-than \u003Cage>",[117,570,571],{},"Modified longer ago than an age.",[102,573,574,582],{},[117,575,576,353,579],{},[14,577,578],{},"-l",[14,580,581],{},"--long",[117,583,584],{},"Print modification time and size.",[102,586,587,593],{},[117,588,589,353,591],{},[14,590,352],{},[14,592,356],{},[117,594,595,596,598],{},"With ",[14,597,578],{},", readable sizes.",[102,600,601,609],{},[117,602,603,353,606],{},[14,604,605],{},"-0",[14,607,608],{},"--print0",[117,610,611,612,561],{},"End each path with a NUL, for ",[14,613,614],{},"xargs -0",[64,616,618],{"id":617},"copy-files","Copy files",[18,620,622],{"className":20,"code":621,"language":22,"meta":23,"style":23},"featherless-cloud volume cp -r .\u002Fweights vol:\u002F\u002Fdatasets\u002Fmodels\u002F\nfeatherless-cloud volume cp vol:\u002F\u002Fdatasets\u002Fmodels\u002Fout.bin .\nfeatherless-cloud volume cp -r vol:\u002F\u002Fdatasets\u002Fmodels vol:\u002F\u002Farchive\u002F\n",[14,623,624,641,655],{"__ignoreMap":23},[27,625,626,628,630,633,635,638],{"class":29,"line":30},[27,627,34],{"class":33},[27,629,38],{"class":37},[27,631,632],{"class":37}," cp",[27,634,321],{"class":87},[27,636,637],{"class":37}," .\u002Fweights",[27,639,640],{"class":37}," vol:\u002F\u002Fdatasets\u002Fmodels\u002F\n",[27,642,643,645,647,649,652],{"class":29,"line":186},[27,644,34],{"class":33},[27,646,38],{"class":37},[27,648,632],{"class":37},[27,650,651],{"class":37}," vol:\u002F\u002Fdatasets\u002Fmodels\u002Fout.bin",[27,653,654],{"class":37}," .\n",[27,656,657,659,661,663,665,668],{"class":29,"line":312},[27,658,34],{"class":33},[27,660,38],{"class":37},[27,662,632],{"class":37},[27,664,321],{"class":87},[27,666,667],{"class":37}," vol:\u002F\u002Fdatasets\u002Fmodels",[27,669,670],{"class":37}," vol:\u002F\u002Farchive\u002F\n",[10,672,673,676,677,680],{},[14,674,675],{},"cp"," works in either direction and between volumes. An interrupted copy resumes when you run it again. A destination ending in ",[14,678,679],{},"\u002F",", or an existing folder, receives each source under its own name.",[96,682,683,691],{},[99,684,685],{},[102,686,687,689],{},[105,688,107],{},[105,690,110],{},[112,692,693,704,714,724,734,744,757],{},[102,694,695,701],{},[117,696,697,353,699],{},[14,698,370],{},[14,700,373],{},[117,702,703],{},"Copy folders and everything in them.",[102,705,706,711],{},[117,707,708],{},[14,709,710],{},"--overwrite",[117,712,713],{},"Replace files that already exist.",[102,715,716,721],{},[117,717,718],{},[14,719,720],{},"--update",[117,722,723],{},"Skip files whose size and modification time already match.",[102,725,726,731],{},[117,727,728],{},[14,729,730],{},"--concurrency \u003Cn>",[117,732,733],{},"Files at a time, 1–32. Default 16.",[102,735,736,741],{},[117,737,738],{},[14,739,740],{},"--dry-run",[117,742,743],{},"Show what would be copied.",[102,745,746,754],{},[117,747,748,353,751],{},[14,749,750],{},"-v",[14,752,753],{},"--verbose",[117,755,756],{},"Print each file.",[102,758,759,764],{},[117,760,761],{},[14,762,763],{},"--progress",[117,765,766],{},"Show a running total.",[64,768,770],{"id":769},"move-files","Move files",[18,772,774],{"className":20,"code":773,"language":22,"meta":23,"style":23},"featherless-cloud volume mv vol:\u002F\u002Fdatasets\u002Ftmp\u002Frun1 vol:\u002F\u002Fdatasets\u002Fruns\u002F\n",[14,775,776],{"__ignoreMap":23},[27,777,778,780,782,785,788],{"class":29,"line":30},[27,779,34],{"class":33},[27,781,38],{"class":37},[27,783,784],{"class":37}," mv",[27,786,787],{"class":37}," vol:\u002F\u002Fdatasets\u002Ftmp\u002Frun1",[27,789,790],{"class":37}," vol:\u002F\u002Fdatasets\u002Fruns\u002F\n",[96,792,793,801],{},[99,794,795],{},[102,796,797,799],{},[105,798,107],{},[105,800,110],{},[112,802,803,812,820,830],{},[102,804,805,809],{},[117,806,807],{},[14,808,710],{},[117,810,811],{},"Replace files at the destination.",[102,813,814,818],{},[117,815,816],{},[14,817,730],{},[117,819,733],{},[102,821,822,828],{},[117,823,824,353,826],{},[14,825,750],{},[14,827,753],{},[117,829,756],{},[102,831,832,836],{},[117,833,834],{},[14,835,763],{},[117,837,766],{},[64,839,841],{"id":840},"sync-a-folder","Sync a folder",[18,843,845],{"className":20,"code":844,"language":22,"meta":23,"style":23},"featherless-cloud volume sync --dry-run .\u002Fweights vol:\u002F\u002Fdatasets\u002Fmodels\nfeatherless-cloud volume sync .\u002Fweights vol:\u002F\u002Fdatasets\u002Fmodels\nfeatherless-cloud volume sync --mode download --mkdirs .\u002Fresults vol:\u002F\u002Fdatasets\u002Fresults\n",[14,846,847,864,876],{"__ignoreMap":23},[27,848,849,851,853,856,859,861],{"class":29,"line":30},[27,850,34],{"class":33},[27,852,38],{"class":37},[27,854,855],{"class":37}," sync",[27,857,858],{"class":87}," --dry-run",[27,860,637],{"class":37},[27,862,863],{"class":37}," vol:\u002F\u002Fdatasets\u002Fmodels\n",[27,865,866,868,870,872,874],{"class":29,"line":186},[27,867,34],{"class":33},[27,869,38],{"class":37},[27,871,855],{"class":37},[27,873,637],{"class":37},[27,875,863],{"class":37},[27,877,878,880,882,884,887,890,893,896],{"class":29,"line":312},[27,879,34],{"class":33},[27,881,38],{"class":37},[27,883,855],{"class":37},[27,885,886],{"class":87}," --mode",[27,888,889],{"class":37}," download",[27,891,892],{"class":87}," --mkdirs",[27,894,895],{"class":37}," .\u002Fresults",[27,897,898],{"class":37}," vol:\u002F\u002Fdatasets\u002Fresults\n",[10,900,901,904,905,908,909,911,912,537,915,561],{},[14,902,903],{},"sync"," sends what changed on each side since the last sync and never deletes. The folder must exist on both sides unless you pass ",[14,906,907],{},"--mkdirs",". A file changed on both sides is a conflict: ",[14,910,903],{}," reports it and exits with code 1. Choose a side with ",[14,913,914],{},"--mode upload --force",[14,916,917],{},"--mode download --force",[96,919,920,928],{},[99,921,922],{},[102,923,924,926],{},[105,925,107],{},[105,927,110],{},[112,929,930,943,952,961,977,987,997,1005,1015],{},[102,931,932,937],{},[117,933,934],{},[14,935,936],{},"--mode \u003Cupload|download|both>",[117,938,939,940,561],{},"Direction. Default ",[14,941,942],{},"both",[102,944,945,949],{},[117,946,947],{},[14,948,740],{},[117,950,951],{},"Show what would be sent and received.",[102,953,954,958],{},[117,955,956],{},[14,957,907],{},[117,959,960],{},"Create missing folders on either side.",[102,962,963,968],{},[117,964,965],{},[14,966,967],{},"--force",[117,969,970,971,537,974,561],{},"Send even when the chosen side is older. Needs ",[14,972,973],{},"--mode upload",[14,975,976],{},"--mode download",[102,978,979,984],{},[117,980,981],{},[14,982,983],{},"--include \u003Cglob>",[117,985,986],{},"Only paths matching a glob. Repeatable.",[102,988,989,994],{},[117,990,991],{},[14,992,993],{},"--exclude \u003Cglob>",[117,995,996],{},"Skip paths matching a glob. Repeatable.",[102,998,999,1003],{},[117,1000,1001],{},[14,1002,730],{},[117,1004,733],{},[102,1006,1007,1013],{},[117,1008,1009,353,1011],{},[14,1010,750],{},[14,1012,753],{},[117,1014,756],{},[102,1016,1017,1021],{},[117,1018,1019],{},[14,1020,763],{},[117,1022,766],{},[64,1024,1026],{"id":1025},"create-folders","Create folders",[18,1028,1030],{"className":20,"code":1029,"language":22,"meta":23,"style":23},"featherless-cloud volume mkdir -p vol:\u002F\u002Fdatasets\u002Fruns\u002F2026-11\n",[14,1031,1032],{"__ignoreMap":23},[27,1033,1034,1036,1038,1041,1044],{"class":29,"line":30},[27,1035,34],{"class":33},[27,1037,38],{"class":37},[27,1039,1040],{"class":37}," mkdir",[27,1042,1043],{"class":87}," -p",[27,1045,1046],{"class":37}," vol:\u002F\u002Fdatasets\u002Fruns\u002F2026-11\n",[96,1048,1049,1057],{},[99,1050,1051],{},[102,1052,1053,1055],{},[105,1054,107],{},[105,1056,110],{},[112,1058,1059],{},[102,1060,1061,1069],{},[117,1062,1063,353,1066],{},[14,1064,1065],{},"-p",[14,1067,1068],{},"--parents",[117,1070,1071],{},"Create missing parent folders.",[64,1073,1075],{"id":1074},"delete-files","Delete files",[18,1077,1079],{"className":20,"code":1078,"language":22,"meta":23,"style":23},"featherless-cloud volume rm vol:\u002F\u002Fdatasets\u002Fold.bin\nfeatherless-cloud volume rm -r vol:\u002F\u002Fdatasets\u002Ftmp\n",[14,1080,1081,1093],{"__ignoreMap":23},[27,1082,1083,1085,1087,1090],{"class":29,"line":30},[27,1084,34],{"class":33},[27,1086,38],{"class":37},[27,1088,1089],{"class":37}," rm",[27,1091,1092],{"class":37}," vol:\u002F\u002Fdatasets\u002Fold.bin\n",[27,1094,1095,1097,1099,1101,1103],{"class":29,"line":186},[27,1096,34],{"class":33},[27,1098,38],{"class":37},[27,1100,1089],{"class":37},[27,1102,321],{"class":87},[27,1104,1105],{"class":37}," vol:\u002F\u002Fdatasets\u002Ftmp\n",[96,1107,1108,1116],{},[99,1109,1110],{},[102,1111,1112,1114],{},[105,1113,107],{},[105,1115,110],{},[112,1117,1118,1129],{},[102,1119,1120,1126],{},[117,1121,1122,353,1124],{},[14,1123,370],{},[14,1125,373],{},[117,1127,1128],{},"Delete folders and everything in them.",[102,1130,1131,1135],{},[117,1132,1133],{},[14,1134,273],{},[117,1136,276],{},[1138,1139,1140],"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 .suJrU, html code.shiki .suJrU{--shiki-default:#FF7B72}html pre.shiki code .sZEs4, html code.shiki .sZEs4{--shiki-default:#E6EDF3}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);}html pre.shiki code .sFSAA, html code.shiki .sFSAA{--shiki-default:#79C0FF}",{"title":23,"searchDepth":186,"depth":186,"links":1142},[1143,1144,1145,1146,1147,1148,1149,1150,1151,1152,1153],{"id":66,"depth":186,"text":67},{"id":137,"depth":186,"text":138},{"id":161,"depth":186,"text":162},{"id":234,"depth":186,"text":235},{"id":279,"depth":186,"text":280},{"id":389,"depth":186,"text":390},{"id":617,"depth":186,"text":618},{"id":769,"depth":186,"text":770},{"id":840,"depth":186,"text":841},{"id":1025,"depth":186,"text":1026},{"id":1074,"depth":186,"text":1075},"Manage network volumes and move files in and out of them from your terminal.","md",{},true,"\u002Fcli\u002Fvolume",{"title":5,"description":1154},"cli\u002Fvolume","vFfory0mkj9gg30snyk63-MCiTXuAnLxmxgdR025rmk",[1163,1167],{"title":1164,"path":1165,"description":1166},"runjob","\u002Fcli\u002Frunjob","Keep track of the Run Jobs you've submitted.",{"title":1168,"path":1169,"description":1170},"templates","\u002Fcli\u002Ftemplates","Save launch settings once and reuse them from your terminal.",1794932601931]