[{"data":1,"prerenderedAt":658},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fadmin":3,"docs-nav":616},{"id":4,"title":5,"body":6,"description":607,"extension":608,"group":609,"meta":610,"navigation":611,"path":612,"seo":613,"stem":614,"__hash__":615},"docs\u002Fdocs\u002F03.admin.md","Set up the panel",{"type":7,"value":8,"toc":592},"minimark",[9,13,22,50,53,58,87,90,130,133,137,146,229,241,252,257,278,281,285,304,407,414,421,424,428,435,518,521,524,528,541,544,548,558,562,568,571,582,586],[10,11,5],"h1",{"id":12},"set-up-the-panel",[14,15,16,17,21],"p",{},"Panel admins run Nebla from the admin area. After the first admin account is created, the admin area opens on ",[18,19,20],"strong",{},"Get Nebla ready",":",[23,24,25,32,38,44],"ol",{},[26,27,28,31],"li",{},[18,29,30],{},"Connect Proxmox."," Done when a location has an online node.",[26,33,34,37],{},[18,35,36],{},"Turn on OS images."," Done when an image is ready somewhere.",[26,39,40,43],{},[18,41,42],{},"Add server types."," Done when one type exists.",[26,45,46,49],{},[18,47,48],{},"Add an IP pool."," Done when a pool has a free address.",[14,51,52],{},"Once all four are done, anyone in a project can create servers and the checklist leaves the menu. The rest of this page covers each part of the admin area.",[54,55,57],"h2",{"id":56},"locations-and-nodes","Locations and nodes",[14,59,60,61,64,65,69,70,73,74,77,78,69,83,86],{},"A location is a Proxmox cluster or standalone node. Choose ",[18,62,63],{},"Connect a location",", give it a name such as ",[66,67,68],"code",{},"home"," or ",[66,71,72],{},"rack-2",", and either ",[18,75,76],{},"Get setup command"," for the ",[79,80,82],"a",{"href":81},"\u002Fdocs\u002Fproxmox#one-line-setup","one-line setup",[18,84,85],{},"Connect manually"," to enter the Proxmox URL, API token, certificate fingerprint and storages yourself.",[14,88,89],{},"A location's page shows its nodes with their status, cores and memory.",[91,92,93,99,106,112,122],"ul",{},[26,94,95,98],{},[18,96,97],{},"Sync nodes"," reads the cluster's nodes again, for example after you add one.",[26,100,101,102,105],{},"Turn a node's ",[18,103,104],{},"Enabled"," switch off to keep new servers off it.",[26,107,108,111],{},[18,109,110],{},"Disk storage override"," puts one node's server disks on a different storage.",[26,113,114,117,118,121],{},[18,115,116],{},"Edit connection"," changes the URL, token or storages. ",[18,119,120],{},"Re-run setup"," runs the setup command again, for example after a certificate renewal.",[26,123,124,125,129],{},"The page warns when the datacenter firewall is off, and when ",[79,126,128],{"href":127},"\u002Fdocs\u002Fvolumes","volumes"," need one more permission on a storage, with the command to run.",[14,131,132],{},"Nebla places new servers only on enabled, online nodes. A location can't be deleted while it still has servers, IP pools, images or server types tied to it.",[54,134,136],{"id":135},"os-images","OS images",[14,138,139,141,142,145],{},[18,140,136],{}," shows a grid of images against locations. Choose ",[18,143,144],{},"Enable"," in a cell and Nebla downloads the official cloud image to the location's nodes through the Proxmox API and builds a template from it. That takes a few minutes. The catalog has:",[147,148,149,162],"table",{},[150,151,152],"thead",{},[153,154,155,159],"tr",{},[156,157,158],"th",{},"Family",[156,160,161],{},"Images",[163,164,165,180,193,206,219],"tbody",{},[153,166,167,171],{},[168,169,170],"td",{},"Debian",[168,172,173,176,177],{},[66,174,175],{},"debian-12",", ",[66,178,179],{},"debian-13",[153,181,182,185],{},[168,183,184],{},"Ubuntu",[168,186,187,176,190],{},[66,188,189],{},"ubuntu-24.04",[66,191,192],{},"ubuntu-26.04",[153,194,195,198],{},[168,196,197],{},"Rocky Linux",[168,199,200,176,203],{},[66,201,202],{},"rocky-9",[66,204,205],{},"rocky-10",[153,207,208,211],{},[168,209,210],{},"AlmaLinux",[168,212,213,176,216],{},[66,214,215],{},"alma-9",[66,217,218],{},"alma-10",[153,220,221,224],{},[168,222,223],{},"Fedora",[168,225,226],{},[66,227,228],{},"fedora-45",[14,230,231,233,234,236,237,240],{},[66,232,205],{}," and ",[66,235,218],{}," run with the ",[66,238,239],{},"x86-64-v3"," CPU type, so the hosts' CPUs must support it.",[14,242,243,244,247,248,251],{},"Built-in images need Proxmox VE 8.4 or later, an import storage on the location, and outbound HTTPS from the nodes. A cell says why when it can't be enabled. ",[18,245,246],{},"Refresh"," rebuilds a ready image from the newest download, and the old template keeps working until the new one replaces it. ",[18,249,250],{},"Disable"," stops new servers from using the image in that location and removes its templates.",[253,254,256],"h3",{"id":255},"your-own-images","Your own images",[14,258,259,260,262,263,266,267,270,271,277],{},"Under ",[18,261,256],{},", choose ",[18,264,265],{},"Add image"," to register a cloud-init template you built yourself. This works on every supported Proxmox version. Give it a name, an OS flavor and version, and one template per location: the VMID, plus the node that holds it, or ",[18,268,269],{},"Shared storage"," when the template sits on storage every node can reach. The ",[79,272,276],{"href":273,"rel":274},"https:\u002F\u002Fgithub.com\u002Fnebla-cloud\u002Fnebla\u002Fblob\u002Fmain\u002Fdocs\u002Fproxmox-setup.md#5-cloud-init-template-debian-13",[275],"nofollow","Proxmox setup reference"," shows how to build one.",[14,279,280],{},"Deleting an image leaves its template in Proxmox alone.",[54,282,284],{"id":283},"server-types","Server types",[14,286,287,288,291,292,295,296,299,300,303],{},"A server type is a size that users pick: cores, memory and disk. Choose ",[18,289,290],{},"New server type",", then either pick a size under ",[18,293,294],{},"Start from a template"," or fill in the fields yourself: a name such as ",[66,297,298],{},"small-2",", the cores, memory in GB and disk in GB. Under ",[18,301,302],{},"Available in"," you can limit a type to some locations.",[147,305,306,322],{},[150,307,308],{},[153,309,310,313,316,319],{},[156,311,312],{},"Template",[156,314,315],{},"Cores",[156,317,318],{},"Memory",[156,320,321],{},"Disk",[163,323,324,338,351,365,379,393],{},[153,325,326,329,332,335],{},[168,327,328],{},"Nano",[168,330,331],{},"1",[168,333,334],{},"0.5 GB",[168,336,337],{},"10 GB",[153,339,340,343,345,348],{},[168,341,342],{},"Small",[168,344,331],{},[168,346,347],{},"1 GB",[168,349,350],{},"25 GB",[153,352,353,356,359,362],{},[168,354,355],{},"Medium",[168,357,358],{},"2",[168,360,361],{},"4 GB",[168,363,364],{},"50 GB",[153,366,367,370,373,376],{},[168,368,369],{},"Large",[168,371,372],{},"4",[168,374,375],{},"8 GB",[168,377,378],{},"100 GB",[153,380,381,384,387,390],{},[168,382,383],{},"XL",[168,385,386],{},"8",[168,388,389],{},"16 GB",[168,391,392],{},"200 GB",[153,394,395,398,401,404],{},[168,396,397],{},"XXL",[168,399,400],{},"16",[168,402,403],{},"32 GB",[168,405,406],{},"400 GB",[14,408,409,410,413],{},"A template only fills in the form, so you can change any value before you save. Templates whose name is already taken are marked ",[18,411,412],{},"Already added",".",[14,415,416,417,420],{},"Tick ",[18,418,419],{},"Deprecated"," to hide a type from new servers. Servers that already use it keep running.",[14,422,423],{},"Keep each template's disk no larger than your smallest server type, because Nebla grows the cloned disk to the type's size and disks never shrink.",[54,425,427],{"id":426},"ip-pools","IP pools",[14,429,430,431,434],{},"An IP pool hands out public addresses in one location. Choose ",[18,432,433],{},"New IP pool"," and fill in:",[147,436,437,447],{},[150,438,439],{},[153,440,441,444],{},[156,442,443],{},"Field",[156,445,446],{},"Example",[163,448,449,456,466,474,484,494,508],{},[153,450,451,453],{},[168,452,158],{},[168,454,455],{},"IPv4 or IPv6",[153,457,458,461],{},[168,459,460],{},"Bridge",[168,462,463],{},[66,464,465],{},"vmbr0",[153,467,468,471],{},[168,469,470],{},"VLAN tag",[168,472,473],{},"Optional, 1 to 4094",[153,475,476,479],{},[168,477,478],{},"CIDR",[168,480,481],{},[66,482,483],{},"203.0.113.0\u002F24",[153,485,486,489],{},[168,487,488],{},"Gateway",[168,490,491],{},[66,492,493],{},"203.0.113.1",[153,495,496,499],{},[168,497,498],{},"Range start and end",[168,500,501,504,505],{},[66,502,503],{},"203.0.113.20"," to ",[66,506,507],{},"203.0.113.200",[153,509,510,513],{},[168,511,512],{},"DNS servers",[168,514,515],{},[66,516,517],{},"1.1.1.1, 9.9.9.9",[14,519,520],{},"Each server gets the lowest free address from the location's pools and keeps it until it's deleted. Cloud-init sets it as a static address. Ranges in one location can't overlap, and a pool can't be deleted while addresses from it are in use. The list shows how many addresses each pool has in use.",[14,522,523],{},"Every server's network card runs the Proxmox firewall with IP and MAC filtering, so a server can't take an address it wasn't given.",[54,525,527],{"id":526},"users","Users",[14,529,530,532,533,536,537,540],{},[18,531,527],{}," lists every account with its two-factor and passkey status. ",[18,534,535],{},"New user"," creates an account with a name, email, password and an optional ",[18,538,539],{},"Panel admin"," tick. Nebla sends no email from here, so give people their password yourself.",[14,542,543],{},"From a user's menu you can edit them, reset their password, turn off two-factor login, remove their passkeys or delete them. The panel always keeps at least one admin, and you can't run these actions on your own account.",[54,545,547],{"id":546},"sign-up","Sign-up",[14,549,550,553,554,557],{},[18,551,552],{},"Settings"," has one switch: ",[18,555,556],{},"Let anyone create an account",". It's off by default, and then people join only through an invite from a project or an account you create. With it on, the login page links to a sign-up page.",[54,559,561],{"id":560},"projects-and-quotas","Projects and quotas",[14,563,564,567],{},[18,565,566],{},"Projects"," lists every project with its owner, servers and members. A project's page shows its usage against its quota, its members and its activity.",[14,569,570],{},"Quotas limit servers, vCPU, memory, disk, IPs, volumes and total volume size. Leave a limit empty or set it to 0 for no limit. Lowering a limit below current use removes nothing, it only refuses new servers.",[14,572,573,574,577,578,413],{},"Projects a non-admin creates start with ",[66,575,576],{},"PANEL_DEFAULT_QUOTA",", and projects an admin creates start unlimited. See ",[79,579,581],{"href":580},"\u002Fdocs\u002Finstall#environment-variables","Install",[54,583,585],{"id":584},"activity","Activity",[14,587,588,589,591],{},"The admin ",[18,590,585],{}," page lists every action in every project, newest first, filtered by project and status. Admins see the technical detail of failed actions here.",{"title":593,"searchDepth":594,"depth":594,"links":595},"",2,[596,597,601,602,603,604,605,606],{"id":56,"depth":594,"text":57},{"id":135,"depth":594,"text":136,"children":598},[599],{"id":255,"depth":600,"text":256},3,{"id":283,"depth":594,"text":284},{"id":426,"depth":594,"text":427},{"id":526,"depth":594,"text":527},{"id":546,"depth":594,"text":547},{"id":560,"depth":594,"text":561},{"id":584,"depth":594,"text":585},"The Get Nebla ready checklist, then locations and nodes, OS images, server types, IP pools, users, project quotas, sign-up and activity in the admin area.","md","Get started",{},true,"\u002Fdocs\u002Fadmin",{"title":5,"description":607},"docs\u002F03.admin","oRHoX61D_8Y5yRwcrmXezg_T3--jQoMORaWgPilVMfE",[617,621,624,628,629,634,638,641,645,650,654],{"path":618,"title":619,"group":609,"stem":620},"\u002Fdocs","Overview","docs\u002F00.index",{"path":622,"title":581,"group":609,"stem":623},"\u002Fdocs\u002Finstall","docs\u002F01.install",{"path":625,"title":626,"group":609,"stem":627},"\u002Fdocs\u002Fproxmox","Connect Proxmox","docs\u002F02.proxmox",{"path":612,"title":5,"group":609,"stem":614},{"path":630,"title":631,"group":632,"stem":633},"\u002Fdocs\u002Fprojects","Projects and access","Use Nebla","docs\u002F04.projects",{"path":635,"title":636,"group":632,"stem":637},"\u002Fdocs\u002Fservers","Servers","docs\u002F05.servers",{"path":127,"title":639,"group":632,"stem":640},"Volumes","docs\u002F06.volumes",{"path":642,"title":643,"group":632,"stem":644},"\u002Fdocs\u002Ffirewalls","Firewalls","docs\u002F07.firewalls",{"path":646,"title":647,"group":648,"stem":649},"\u002Fdocs\u002Fcli","CLI","Reference","docs\u002F08.cli",{"path":651,"title":652,"group":648,"stem":653},"\u002Fdocs\u002Fapi","API","docs\u002F09.api",{"path":655,"title":656,"group":648,"stem":657},"\u002Fdocs\u002Ftroubleshooting","Troubleshooting","docs\u002F10.troubleshooting",1795243967229]