[{"data":1,"prerenderedAt":348},["ShallowReactive",2],{"docs-\u002Fdocs\u002Ftroubleshooting":3,"docs-nav":308},{"id":4,"title":5,"body":6,"description":299,"extension":300,"group":301,"meta":302,"navigation":303,"path":304,"seo":305,"stem":306,"__hash__":307},"docs\u002Fdocs\u002F10.troubleshooting.md","Troubleshooting",{"type":7,"value":8,"toc":288},"minimark",[9,13,18,30,36,57,69,77,81,95,104,118,122,128,134,140,149,155,169,173,182,188,206,210,216,222,226,236,245,254,258],[10,11,5],"h1",{"id":12},"troubleshooting",[14,15,17],"h2",{"id":16},"setup","Setup",[19,20,21,25,26,29],"p",{},[22,23,24],"strong",{},"The setup command says it expired."," A setup command is valid for 30 minutes and works once. Choose ",[22,27,28],{},"New command"," on the enrollment page and run the new one.",[19,31,32,35],{},[22,33,34],{},"The report expired."," After the node reports, you have 24 hours to finish on the enrollment page. Cancel the enrollment and run setup again.",[19,37,38,41,42,45,46,50,51,56],{},[22,39,40],{},"The node can't reach the panel."," Use the offline script under ",[22,43,44],{},"The node can't reach this panel?"," on the enrollment page, and paste the ",[47,48,49],"code",{},"nebla-enroll:v1:"," line it prints. See ",[52,53,55],"a",{"href":54},"\u002Fdocs\u002Fproxmox#if-the-node-cant-reach-the-panel","Connect Proxmox",".",[19,58,59,65,66,56],{},[22,60,61,62,56],{},"Connecting fails with ",[47,63,64],{},"fingerprint_mismatch"," The certificate the panel sees is not one the node reported. Check that the Proxmox URL points at a node of this cluster and that no proxy sits in between. After a certificate renewal, use ",[22,67,68],{},"Re-run setup",[19,70,71,76],{},[22,72,61,73,56],{},[47,74,75],{},"pve_unreachable"," The panel can't reach the Proxmox URL. Check that port 8006 is open from the machine that runs Nebla.",[14,78,80],{"id":79},"os-images","OS images",[19,82,83,86,87,90,91,56],{},[22,84,85],{},"A cell says \"location has no import_storage\"."," Built-in images need an import storage. Add ",[47,88,89],{},"import"," to a file storage's content types and pick it on the location. See ",[52,92,94],{"href":93},"\u002Fdocs\u002Fproxmox#storages","Storages",[19,96,97,100,101,56],{},[22,98,99],{},"A cell says \"no online node runs Proxmox VE 8.4 or later\"."," Built-in images download through Proxmox's import feature, which needs 8.4. Upgrade the nodes, or register a template you built yourself under ",[22,102,103],{},"Your own images",[19,105,106,109,110,113,114,117],{},[22,107,108],{},"An image shows Failed or Partial."," Check that the nodes have outbound HTTPS to the image's download site, then choose ",[22,111,112],{},"Retry",". Panel admins see the technical error on the admin ",[22,115,116],{},"Activity"," page.",[14,119,121],{"id":120},"servers","Servers",[19,123,124,127],{},[22,125,126],{},"\"No free addresses in …\""," Every address in the location's IP pools is taken. A panel admin can add a pool or widen a range.",[19,129,130,133],{},[22,131,132],{},"\"This server doesn't fit in the project's quota.\""," Delete something, pick a smaller type, or ask a panel admin to raise the project's quota.",[19,135,136,139],{},[22,137,138],{},"\"no node in this location has capacity for this server\""," No enabled, online node has enough free memory, or none has the image's template.",[19,141,142,145,146,56],{},[22,143,144],{},"The console is blank."," The template probably uses a serial display. Nebla doesn't change the display type, so fix the template in Proxmox with ",[47,147,148],{},"qm set \u003Cvmid> --vga std",[19,150,151,154],{},[22,152,153],{},"Resize asks you to shut the server down."," Changing a server's type needs it off. Shut it down from the Overview tab first.",[19,156,157,160,161,164,165,168],{},[22,158,159],{},"Shut down or Reboot times out."," The OS didn't respond to the ACPI request within 2 minutes. Use ",[22,162,163],{},"Power off"," or ",[22,166,167],{},"Reset"," instead.",[14,170,172],{"id":171},"volumes","Volumes",[19,174,175,178,179,56],{},[22,176,177],{},"Volumes doesn't appear in the menu."," No location offers volumes yet. A panel admin must grant the token its storage permission. The location page shows the command under \"Volumes need one more permission\". Run it, then choose ",[22,180,181],{},"Sync nodes",[19,183,184,187],{},[22,185,186],{},"\"Power off the server to attach the volume.\""," Some servers can't take a volume while running. Power the server off and try again.",[19,189,190,193,194,197,198,201,202,56],{},[22,191,192],{},"The server stops at boot after a volume was detached."," Its ",[47,195,196],{},"\u002Fetc\u002Ffstab"," line is missing ",[47,199,200],{},"nofail",". See ",[52,203,205],{"href":204},"\u002Fdocs\u002Fvolumes#format-and-mount","Format and mount",[14,207,209],{"id":208},"firewalls","Firewalls",[19,211,212,215],{},[22,213,214],{},"Rules don't take effect."," The Proxmox datacenter firewall is off. The location page warns about it. Turn it on under Datacenter > Firewall > Options.",[19,217,218,221],{},[22,219,220],{},"A server lost outbound access."," Once any of a server's firewalls has an outbound rule, only what outbound rules allow gets out. Add the outbound rules it needs, such as DNS and HTTPS.",[14,223,225],{"id":224},"sign-in","Sign-in",[19,227,228,231,232,235],{},[22,229,230],{},"The account page says \"Passkeys need this panel on https with a domain name.\""," Set ",[47,233,234],{},"PANEL_BASE_URL"," to an https URL with a domain name and restart Nebla.",[19,237,238,241,242,244],{},[22,239,240],{},"Passkeys stopped working after a move."," Passkeys are tied to the host in ",[47,243,234],{},". Sign in with your password and add new passkeys.",[19,246,247,250,251,56],{},[22,248,249],{},"You lost your authenticator."," A panel admin can turn off two-factor login for your account from ",[22,252,253],{},"Users",[14,255,257],{"id":256},"get-help","Get help",[259,260,261,271,279],"ul",{},[262,263,264,265,56],"li",{},"Ask in the ",[52,266,270],{"href":267,"rel":268},"https:\u002F\u002Fnebla.dev\u002Fdiscord",[269],"nofollow","Nebla Discord",[262,272,273,274,56],{},"Report bugs in ",[52,275,278],{"href":276,"rel":277},"https:\u002F\u002Fgithub.com\u002Fnebla-cloud\u002Fnebla\u002Fissues",[269],"GitHub issues",[262,280,281,282,287],{},"Report security problems through ",[52,283,286],{"href":284,"rel":285},"https:\u002F\u002Fgithub.com\u002Fnebla-cloud\u002Fnebla\u002Fsecurity",[269],"private vulnerability reporting",", never in public.",{"title":289,"searchDepth":290,"depth":290,"links":291},"",2,[292,293,294,295,296,297,298],{"id":16,"depth":290,"text":17},{"id":79,"depth":290,"text":80},{"id":120,"depth":290,"text":121},{"id":171,"depth":290,"text":172},{"id":208,"depth":290,"text":209},{"id":224,"depth":290,"text":225},{"id":256,"depth":290,"text":257},"Fixes for common problems with setup, images, servers, the console, volumes, firewalls and sign-in, and where to ask for help.","md","Reference",{},true,"\u002Fdocs\u002Ftroubleshooting",{"title":5,"description":299},"docs\u002F10.troubleshooting","fuHassXnCI-Y5i6UDyj7ABqaDHw4RlgdeNlf1dV_eg8",[309,314,318,321,325,330,333,336,339,343,347],{"path":310,"title":311,"group":312,"stem":313},"\u002Fdocs","Overview","Get started","docs\u002F00.index",{"path":315,"title":316,"group":312,"stem":317},"\u002Fdocs\u002Finstall","Install","docs\u002F01.install",{"path":319,"title":55,"group":312,"stem":320},"\u002Fdocs\u002Fproxmox","docs\u002F02.proxmox",{"path":322,"title":323,"group":312,"stem":324},"\u002Fdocs\u002Fadmin","Set up the panel","docs\u002F03.admin",{"path":326,"title":327,"group":328,"stem":329},"\u002Fdocs\u002Fprojects","Projects and access","Use Nebla","docs\u002F04.projects",{"path":331,"title":121,"group":328,"stem":332},"\u002Fdocs\u002Fservers","docs\u002F05.servers",{"path":334,"title":172,"group":328,"stem":335},"\u002Fdocs\u002Fvolumes","docs\u002F06.volumes",{"path":337,"title":209,"group":328,"stem":338},"\u002Fdocs\u002Ffirewalls","docs\u002F07.firewalls",{"path":340,"title":341,"group":301,"stem":342},"\u002Fdocs\u002Fcli","CLI","docs\u002F08.cli",{"path":344,"title":345,"group":301,"stem":346},"\u002Fdocs\u002Fapi","API","docs\u002F09.api",{"path":304,"title":5,"group":301,"stem":306},1795243967234]