[{"data":1,"prerenderedAt":406},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fservers":3,"docs-nav":367},{"id":4,"title":5,"body":6,"description":358,"extension":359,"group":360,"meta":361,"navigation":362,"path":363,"seo":364,"stem":365,"__hash__":366},"docs\u002Fdocs\u002F05.servers.md","Servers",{"type":7,"value":8,"toc":347},"minimark",[9,13,17,22,33,85,88,91,99,163,167,180,184,244,247,250,254,264,279,283,288,292,297,301,310,314,322,326,340,343],[10,11,5],"h1",{"id":12},"servers",[14,15,16],"p",{},"A server is a Proxmox VM that Nebla clones from an image template, with a fixed size from a server type and addresses from an IP pool. Nebla picks the node, the VM ID and the storage, so you don't have to.",[18,19,21],"h2",{"id":20},"create-a-server","Create a server",[14,23,24,25,28,29,32],{},"Open ",[26,27,5],"strong",{}," and choose ",[26,30,31],{},"Create server",". The page has one step per choice:",[34,35,36,43,49,55,61,67,79],"ol",{},[37,38,39,42],"li",{},[26,40,41],{},"Location."," The Proxmox cluster or node to run on.",[37,44,45,48],{},[26,46,47],{},"Image."," The operating system. Images not offered in the chosen location are marked.",[37,50,51,54],{},[26,52,53],{},"Type."," vCPU, memory and disk.",[37,56,57,60],{},[26,58,59],{},"Networking."," A public IPv4 address is on by default, IPv6 is optional.",[37,62,63,66],{},[26,64,65],{},"SSH keys."," Keys to install for the image's default user. You can add one here.",[37,68,69,72,73,78],{},[26,70,71],{},"Firewalls."," Shown when the project has ",[74,75,77],"a",{"href":76},"\u002Fdocs\u002Ffirewalls","firewalls",".",[37,80,81,84],{},[26,82,83],{},"Cloud-init."," Optional user data, up to 32 KiB, to install packages or run commands on first boot.",[14,86,87],{},"The summary beside the steps suggests a name, which you can change, and shows the project's quota before and after this server. If the server doesn't fit the quota, Create is blocked. Names use lowercase letters, digits and hyphens.",[14,89,90],{},"Nebla places the server on the online node with the most free memory that has the image, gives it a static address through cloud-init, and starts it.",[14,92,93,94,98],{},"The same thing from the ",[74,95,97],{"href":96},"\u002Fdocs\u002Fcli","CLI",":",[100,101,106],"pre",{"className":102,"code":103,"language":104,"meta":105,"style":105},"language-sh shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-high-contrast","nebla server create --name web1 --type small-2 --image debian-13 --ssh-key laptop \\\n  --user-data-from-file cloud-init.yaml\n","sh","",[107,108,109,154],"code",{"__ignoreMap":105},[110,111,114,118,122,125,129,132,135,138,141,144,147,150],"span",{"class":112,"line":113},"line",1,[110,115,117],{"class":116},"szw1H","nebla",[110,119,121],{"class":120},"semJd"," server",[110,123,124],{"class":120}," create",[110,126,128],{"class":127},"ssYy9"," --name",[110,130,131],{"class":120}," web1",[110,133,134],{"class":127}," --type",[110,136,137],{"class":120}," small-2",[110,139,140],{"class":127}," --image",[110,142,143],{"class":120}," debian-13",[110,145,146],{"class":127}," --ssh-key",[110,148,149],{"class":120}," laptop",[110,151,153],{"class":152},"sklAV"," \\\n",[110,155,157,160],{"class":112,"line":156},2,[110,158,159],{"class":127},"  --user-data-from-file",[110,161,162],{"class":120}," cloud-init.yaml\n",[18,164,166],{"id":165},"overview","Overview",[14,168,169,170,172,173,176,177,179],{},"A server's ",[26,171,166],{}," tab shows its status, addresses, image, type and location, live CPU, network and disk use, and its three most recent actions. You can rename the server and edit its labels here. Labels are ",[107,174,175],{},"key=value"," pairs that ",[74,178,77],{"href":76}," and filters select on.",[18,181,183],{"id":182},"power","Power",[185,186,187,200],"table",{},[188,189,190],"thead",{},[191,192,193,197],"tr",{},[194,195,196],"th",{},"Button",[194,198,199],{},"What it does",[201,202,203,212,220,228,236],"tbody",{},[191,204,205,209],{},[206,207,208],"td",{},"Power on",[206,210,211],{},"Starts the server.",[191,213,214,217],{},[206,215,216],{},"Shut down",[206,218,219],{},"Asks the OS to shut down cleanly.",[191,221,222,225],{},[206,223,224],{},"Reboot",[206,226,227],{},"Asks the OS to restart cleanly.",[191,229,230,233],{},[206,231,232],{},"Power off",[206,234,235],{},"Stops the server straight away, like pulling the plug.",[191,237,238,241],{},[206,239,240],{},"Reset",[206,242,243],{},"Restarts the server straight away.",[14,245,246],{},"Power off and Reset sit under the menu on a running server. A power action that hasn't finished after 2 minutes fails as timed out.",[14,248,249],{},"Images built from the built-in catalog don't ship the QEMU guest agent. Shut down and Reboot use ACPI, and graphs work without it.",[18,251,253],{"id":252},"console","Console",[14,255,256,257,259,260,263],{},"The ",[26,258,253],{}," tab opens the server's screen in the browser. It has buttons for Ctrl+Alt+Del, pasting text and full screen, and ",[26,261,262],{},"Pop out"," opens it in its own window. Nebla proxies the connection, so you never need Proxmox credentials or network access to the host.",[265,266,267,270,273,276],"ul",{},[37,268,269],{},"The server must be running.",[37,271,272],{},"One console session runs at a time.",[37,274,275],{},"A session closes after 30 minutes idle, or after 8 hours.",[37,277,278],{},"Paste types US-keyboard ASCII only.",[18,280,282],{"id":281},"graphs","Graphs",[14,284,256,285,287],{},[26,286,282],{}," tab shows CPU, disk read and write, and network in and out, over the last hour, day, week or month. The hour view refreshes every minute.",[18,289,291],{"id":290},"rebuild","Rebuild",[14,293,294,296],{},[26,295,291],{}," erases the server's disk and reinstalls it from the image you pick. The server keeps its name, addresses and attached volumes. A running server starts again afterwards.",[18,298,300],{"id":299},"resize","Resize",[14,302,303,305,306,309],{},[26,304,300],{}," changes the server type. Shut the server down first. Tick ",[26,307,308],{},"Grow the disk too"," to give it the new type's disk size. Without it, the disk keeps its current size, so you can try a bigger type and move back later. Disks never shrink.",[18,311,313],{"id":312},"delete","Delete",[14,315,316,317,321],{},"Delete is on the Overview tab, and you confirm it by typing the server's name. Nebla deletes the VM and frees its addresses. Attached ",[74,318,320],{"href":319},"\u002Fdocs\u002Fvolumes","volumes"," are detached and kept.",[18,323,325],{"id":324},"activity","Activity",[14,327,328,329,333,334,336,337,339],{},"Every change runs as an ",[74,330,332],{"href":331},"\u002Fdocs\u002Fapi#actions","action"," with a status and progress. The server's ",[26,335,325],{}," tab lists its actions, and the project's ",[26,338,325],{}," page lists them all, filtered by running or failed. A failed action shows a plain message. Panel admins also see the technical detail.",[14,341,342],{},"While an action runs on a server, a second change to the same server is refused as locked until the first one finishes.",[344,345,346],"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 pre.shiki code .sklAV, html code.shiki .sklAV{--shiki-light:#A0111F;--shiki-default:#A0111F;--shiki-dark:#FF9492}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);}",{"title":105,"searchDepth":156,"depth":156,"links":348},[349,350,351,352,353,354,355,356,357],{"id":20,"depth":156,"text":21},{"id":165,"depth":156,"text":166},{"id":182,"depth":156,"text":183},{"id":252,"depth":156,"text":253},{"id":281,"depth":156,"text":282},{"id":290,"depth":156,"text":291},{"id":299,"depth":156,"text":300},{"id":312,"depth":156,"text":313},{"id":324,"depth":156,"text":325},"Create a server, then power it, rebuild it, resize it, open its console, read its graphs and delete it.","md","Use Nebla",{},true,"\u002Fdocs\u002Fservers",{"title":5,"description":358},"docs\u002F05.servers","1ub-vi8zzrgJpf4qtbme7G1wCdUn6dxd5NOtNVRR9hE",[368,372,376,380,384,388,389,392,395,398,402],{"path":369,"title":166,"group":370,"stem":371},"\u002Fdocs","Get started","docs\u002F00.index",{"path":373,"title":374,"group":370,"stem":375},"\u002Fdocs\u002Finstall","Install","docs\u002F01.install",{"path":377,"title":378,"group":370,"stem":379},"\u002Fdocs\u002Fproxmox","Connect Proxmox","docs\u002F02.proxmox",{"path":381,"title":382,"group":370,"stem":383},"\u002Fdocs\u002Fadmin","Set up the panel","docs\u002F03.admin",{"path":385,"title":386,"group":360,"stem":387},"\u002Fdocs\u002Fprojects","Projects and access","docs\u002F04.projects",{"path":363,"title":5,"group":360,"stem":365},{"path":319,"title":390,"group":360,"stem":391},"Volumes","docs\u002F06.volumes",{"path":76,"title":393,"group":360,"stem":394},"Firewalls","docs\u002F07.firewalls",{"path":96,"title":97,"group":396,"stem":397},"Reference","docs\u002F08.cli",{"path":399,"title":400,"group":396,"stem":401},"\u002Fdocs\u002Fapi","API","docs\u002F09.api",{"path":403,"title":404,"group":396,"stem":405},"\u002Fdocs\u002Ftroubleshooting","Troubleshooting","docs\u002F10.troubleshooting",1795243967230]