[{"data":1,"prerenderedAt":465},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fvolumes":3,"docs-nav":426},{"id":4,"title":5,"body":6,"description":417,"extension":418,"group":419,"meta":420,"navigation":421,"path":422,"seo":423,"stem":424,"__hash__":425},"docs\u002Fdocs\u002F06.volumes.md","Volumes",{"type":7,"value":8,"toc":410},"minimark",[9,13,17,48,53,60,104,107,120,124,131,145,148,174,178,181,229,236,247,262,273,277,280,301,304,335,339,342,384,387,390,406],[10,11,5],"h1",{"id":12},"volumes",[14,15,16],"p",{},"A volume is extra disk space you attach to a server. It keeps its data when you detach it, rebuild the server or delete the server, and you can attach it to another server in the same location later. Volumes count against the project's quota.",[14,18,19,20,23,24,26,27,32,33,37,38,42,43,47],{},"Manage volumes on the ",[21,22,5],"strong",{}," page, on a server's ",[21,25,5],{}," tab, with the ",[28,29,31],"a",{"href":30},"\u002Fdocs\u002Fcli","CLI"," (",[34,35,36],"code",{},"nebla volume …",") or the ",[28,39,41],{"href":40},"\u002Fdocs\u002Fapi","API",". If Volumes doesn't appear, no location in the panel offers volumes yet. A panel admin sets that up per location (see ",[28,44,46],{"href":45},"\u002Fdocs\u002Fproxmox#storages","Connect Proxmox",").",[49,50,52],"h2",{"id":51},"create-a-volume","Create a volume",[14,54,55,56,59],{},"Choose ",[21,57,58],{},"Create volume"," and give it a name, a size from 10 to 10240 GB, and a location. You can attach it to a server in the same location straight away.",[61,62,67],"pre",{"className":63,"code":64,"language":65,"meta":66,"style":66},"language-sh shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","nebla volume create --name data --size 50 --server web1\n","sh","",[34,68,69],{"__ignoreMap":66},[70,71,74,78,82,85,89,92,95,98,101],"span",{"class":72,"line":73},"line",1,[70,75,77],{"class":76},"szw1H","nebla",[70,79,81],{"class":80},"semJd"," volume",[70,83,84],{"class":80}," create",[70,86,88],{"class":87},"ssYy9"," --name",[70,90,91],{"class":80}," data",[70,93,94],{"class":87}," --size",[70,96,97],{"class":87}," 50",[70,99,100],{"class":87}," --server",[70,102,103],{"class":80}," web1\n",[14,105,106],{},"Some rules:",[108,109,110,114,117],"ul",{},[111,112,113],"li",{},"A volume and its server must be in the same location. In some locations a volume also stays on one host, so it attaches only to servers on that host. The panel greys out servers it can't attach to and says why.",[111,115,116],{},"A server holds at most 14 volumes.",[111,118,119],{},"Some servers can't take a volume while running. If attaching fails with \"Power off the server to attach the volume.\", power it off and try again.",[49,121,123],{"id":122},"find-the-disk","Find the disk",[14,125,126,127,130],{},"Linux names disks like ",[34,128,129],{},"\u002Fdev\u002Fvdb"," in the order they were attached, so the name can change after a detach, a reboot or a rebuild. Use the stable path instead. The panel shows it on the volume and on the server's Volumes tab:",[61,132,134],{"className":63,"code":133,"language":65,"meta":66,"style":66},"\u002Fdev\u002Fdisk\u002Fby-id\u002Fvirtio-nb-vol-\u003Cid>\n",[34,135,136],{"__ignoreMap":66},[70,137,138,141],{"class":72,"line":73},[70,139,140],{"class":76},"\u002Fdev\u002Fdisk\u002Fby-id\u002Fvirtio-nb-vol-",[70,142,144],{"class":143},"s7iLA","\u003Cid>\n",[14,146,147],{},"To list the volumes a server can see:",[61,149,151],{"className":63,"code":150,"language":65,"meta":66,"style":66},"ls -l \u002Fdev\u002Fdisk\u002Fby-id\u002F | grep nb-vol\n",[34,152,153],{"__ignoreMap":66},[70,154,155,158,161,164,168,171],{"class":72,"line":73},[70,156,157],{"class":76},"ls",[70,159,160],{"class":87}," -l",[70,162,163],{"class":80}," \u002Fdev\u002Fdisk\u002Fby-id\u002F",[70,165,167],{"class":166},"sklAV"," |",[70,169,170],{"class":76}," grep",[70,172,173],{"class":80}," nb-vol\n",[49,175,177],{"id":176},"format-and-mount","Format and mount",[14,179,180],{},"A new volume is empty. Make a filesystem on it once. This erases whatever is on the volume:",[61,182,184],{"className":63,"code":183,"language":65,"meta":66,"style":66},"sudo mkfs.ext4 -L data \u002Fdev\u002Fdisk\u002Fby-id\u002Fvirtio-nb-vol-42\nsudo mkdir -p \u002Fmnt\u002Fdata\nsudo mount \u002Fdev\u002Fdisk\u002Fby-id\u002Fvirtio-nb-vol-42 \u002Fmnt\u002Fdata\n",[34,185,186,202,216],{"__ignoreMap":66},[70,187,188,191,194,197,199],{"class":72,"line":73},[70,189,190],{"class":76},"sudo",[70,192,193],{"class":80}," mkfs.ext4",[70,195,196],{"class":87}," -L",[70,198,91],{"class":80},[70,200,201],{"class":80}," \u002Fdev\u002Fdisk\u002Fby-id\u002Fvirtio-nb-vol-42\n",[70,203,205,207,210,213],{"class":72,"line":204},2,[70,206,190],{"class":76},[70,208,209],{"class":80}," mkdir",[70,211,212],{"class":87}," -p",[70,214,215],{"class":80}," \u002Fmnt\u002Fdata\n",[70,217,219,221,224,227],{"class":72,"line":218},3,[70,220,190],{"class":76},[70,222,223],{"class":80}," mount",[70,225,226],{"class":80}," \u002Fdev\u002Fdisk\u002Fby-id\u002Fvirtio-nb-vol-42",[70,228,215],{"class":80},[14,230,231,232,235],{},"For XFS, use ",[34,233,234],{},"sudo mkfs.xfs -L data"," instead.",[14,237,238,239,242,243,246],{},"To mount it at every boot, add a line to ",[34,240,241],{},"\u002Fetc\u002Ffstab"," that uses the label, not ",[34,244,245],{},"\u002Fdev\u002FvdX",":",[61,248,252],{"className":249,"code":250,"language":251,"meta":66,"style":66},"language-ini shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","LABEL=data  \u002Fmnt\u002Fdata  ext4  defaults,nofail  0  2\n","ini",[34,253,254],{"__ignoreMap":66},[70,255,256,259],{"class":72,"line":73},[70,257,258],{"class":166},"LABEL",[70,260,261],{"class":143},"=data  \u002Fmnt\u002Fdata  ext4  defaults,nofail  0  2\n",[14,263,264,265,268,269,272],{},"Keep ",[34,266,267],{},"nofail",". Without it the server stops at boot when the volume is detached. Check the line with ",[34,270,271],{},"sudo mount -a"," before you reboot.",[49,274,276],{"id":275},"make-it-bigger","Make it bigger",[14,278,279],{},"Volumes only grow, up to 10240 GB. Resize in the panel or with:",[61,281,283],{"className":63,"code":282,"language":65,"meta":66,"style":66},"nebla volume resize data --size 100\n",[34,284,285],{"__ignoreMap":66},[70,286,287,289,291,294,296,298],{"class":72,"line":73},[70,288,77],{"class":76},[70,290,81],{"class":80},[70,292,293],{"class":80}," resize",[70,295,91],{"class":80},[70,297,94],{"class":87},[70,299,300],{"class":87}," 100\n",[14,302,303],{},"An attached volume shows its new size on the server within a few seconds. A detached volume gets its new size when you next attach it. Then grow the filesystem, which works while it's mounted:",[61,305,307],{"className":63,"code":306,"language":65,"meta":66,"style":66},"sudo resize2fs \u002Fdev\u002Fdisk\u002Fby-id\u002Fvirtio-nb-vol-42   # ext4\nsudo xfs_growfs \u002Fmnt\u002Fdata                          # XFS takes the mount point\n",[34,308,309,322],{"__ignoreMap":66},[70,310,311,313,316,318],{"class":72,"line":73},[70,312,190],{"class":76},[70,314,315],{"class":80}," resize2fs",[70,317,226],{"class":80},[70,319,321],{"class":320},"sq92B","   # ext4\n",[70,323,324,326,329,332],{"class":72,"line":204},[70,325,190],{"class":76},[70,327,328],{"class":80}," xfs_growfs",[70,330,331],{"class":80}," \u002Fmnt\u002Fdata",[70,333,334],{"class":320},"                          # XFS takes the mount point\n",[49,336,338],{"id":337},"detach-move-and-delete","Detach, move and delete",[14,340,341],{},"Stop anything using the volume and unmount it first, or data still in memory can be lost:",[61,343,345],{"className":63,"code":344,"language":65,"meta":66,"style":66},"sudo umount \u002Fmnt\u002Fdata\nnebla volume detach data\nnebla volume attach data --server web2\n",[34,346,347,356,368],{"__ignoreMap":66},[70,348,349,351,354],{"class":72,"line":73},[70,350,190],{"class":76},[70,352,353],{"class":80}," umount",[70,355,215],{"class":80},[70,357,358,360,362,365],{"class":72,"line":204},[70,359,77],{"class":76},[70,361,81],{"class":80},[70,363,364],{"class":80}," detach",[70,366,367],{"class":80}," data\n",[70,369,370,372,374,377,379,381],{"class":72,"line":218},[70,371,77],{"class":76},[70,373,81],{"class":80},[70,375,376],{"class":80}," attach",[70,378,91],{"class":80},[70,380,100],{"class":87},[70,382,383],{"class":80}," web2\n",[14,385,386],{},"To delete a volume, detach it first. Deleting erases its data for good.",[14,388,389],{},"When you delete a server, its volumes are detached and kept. When you rebuild a server, its volumes stay attached.",[14,391,392,393,399,400,405],{},"The ",[28,394,398],{"href":395,"rel":396},"https:\u002F\u002Fgithub.com\u002Fnebla-cloud\u002Fnebla\u002Fblob\u002Fmain\u002Fdocs\u002Fvolumes.md",[397],"nofollow","volumes guide"," in the repository has more detail, and the ",[28,401,404],{"href":402,"rel":403},"https:\u002F\u002Fgithub.com\u002Fnebla-cloud\u002Fnebla\u002Fblob\u002Fmain\u002Fdocs\u002Fproxmox-setup.md#9-volumes",[397],"Proxmox setup reference"," explains how volumes look on the Proxmox side.",[407,408,409],"style",{},"html pre.shiki code .szw1H, html code.shiki .szw1H{--shiki-light:#702C00;--shiki-default:#702C00;--shiki-dark:#FFB757}html pre.shiki code .semJd, html code.shiki .semJd{--shiki-light:#032563;--shiki-default:#032563;--shiki-dark:#ADDCFF}html pre.shiki code .ssYy9, html code.shiki .ssYy9{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#91CBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}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 .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s7iLA, html code.shiki .s7iLA{--shiki-light:#0E1116;--shiki-default:#0E1116;--shiki-dark:#F0F3F6}html pre.shiki code .sklAV, html code.shiki .sklAV{--shiki-light:#A0111F;--shiki-default:#A0111F;--shiki-dark:#FF9492}html pre.shiki code .sq92B, html code.shiki .sq92B{--shiki-light:#66707B;--shiki-default:#66707B;--shiki-dark:#BDC4CC}",{"title":66,"searchDepth":204,"depth":204,"links":411},[412,413,414,415,416],{"id":51,"depth":204,"text":52},{"id":122,"depth":204,"text":123},{"id":176,"depth":204,"text":177},{"id":275,"depth":204,"text":276},{"id":337,"depth":204,"text":338},"Create extra disks, attach them to servers, format and mount them, grow them, and move them between servers.","md","Use Nebla",{},true,"\u002Fdocs\u002Fvolumes",{"title":5,"description":417},"docs\u002F06.volumes","OIwfBW70hUkG7iCkQj4-8QA5Nkl_h-P8uQsNM9TQdd8",[427,432,436,439,443,447,451,452,456,459,461],{"path":428,"title":429,"group":430,"stem":431},"\u002Fdocs","Overview","Get started","docs\u002F00.index",{"path":433,"title":434,"group":430,"stem":435},"\u002Fdocs\u002Finstall","Install","docs\u002F01.install",{"path":437,"title":46,"group":430,"stem":438},"\u002Fdocs\u002Fproxmox","docs\u002F02.proxmox",{"path":440,"title":441,"group":430,"stem":442},"\u002Fdocs\u002Fadmin","Set up the panel","docs\u002F03.admin",{"path":444,"title":445,"group":419,"stem":446},"\u002Fdocs\u002Fprojects","Projects and access","docs\u002F04.projects",{"path":448,"title":449,"group":419,"stem":450},"\u002Fdocs\u002Fservers","Servers","docs\u002F05.servers",{"path":422,"title":5,"group":419,"stem":424},{"path":453,"title":454,"group":419,"stem":455},"\u002Fdocs\u002Ffirewalls","Firewalls","docs\u002F07.firewalls",{"path":30,"title":31,"group":457,"stem":458},"Reference","docs\u002F08.cli",{"path":40,"title":41,"group":457,"stem":460},"docs\u002F09.api",{"path":462,"title":463,"group":457,"stem":464},"\u002Fdocs\u002Ftroubleshooting","Troubleshooting","docs\u002F10.troubleshooting",1795243967231]