[{"data":1,"prerenderedAt":324},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fprojects":3,"docs-nav":284},{"id":4,"title":5,"body":6,"description":275,"extension":276,"group":277,"meta":278,"navigation":279,"path":280,"seo":281,"stem":282,"__hash__":283},"docs\u002Fdocs\u002F04.projects.md","Projects and access",{"type":7,"value":8,"toc":265},"minimark",[9,13,17,22,30,48,56,69,73,125,128,132,143,158,162,174,183,187,201,219,232,236,242,262],[10,11,5],"h1",{"id":12},"projects-and-access",[14,15,16],"p",{},"Everything you create in Nebla, such as servers, volumes, firewalls, SSH keys and API tokens, belongs to a project. People see only the projects they are members of.",[18,19,21],"h2",{"id":20},"projects","Projects",[14,23,24,25,29],{},"Any user can create a project and becomes its owner. A non-admin user can own up to 3 projects unless the panel admin changes ",[26,27,28],"code",{},"PANEL_MAX_PROJECTS_PER_USER",". Projects a non-admin creates get the panel's default quota. Projects a panel admin creates have no limits.",[14,31,32,33,37,38,41,42,37,45,47],{},"Switch projects from the project menu in the top bar. Press ",[34,35,36],"kbd",{},"⌘"," ",[34,39,40],{},"K"," on a Mac, or ",[34,43,44],{},"Ctrl",[34,46,40],{}," elsewhere, to search pages, servers and SSH keys.",[14,49,50,51,55],{},"Under ",[52,53,54],"strong",{},"Settings"," in a project:",[57,58,59,63,66],"ul",{},[60,61,62],"li",{},"Owners and admins can rename the project.",[60,64,65],{},"Any member can leave it. The only owner can't leave until someone else is an owner too.",[60,67,68],{},"An owner can delete the project by typing its name. Delete its servers and volumes first.",[18,70,72],{"id":71},"roles","Roles",[74,75,76,89],"table",{},[77,78,79],"thead",{},[80,81,82,86],"tr",{},[83,84,85],"th",{},"Role",[83,87,88],{},"Can do",[90,91,92,101,109,117],"tbody",{},[80,93,94,98],{},[95,96,97],"td",{},"Owner",[95,99,100],{},"Everything, including deleting the project and adding or removing other owners.",[80,102,103,106],{},[95,104,105],{},"Admin",[95,107,108],{},"Everything except deleting the project or changing owners. Manages members, invites and API tokens.",[80,110,111,114],{},[95,112,113],{},"Member",[95,115,116],{},"Creates, changes and deletes servers, volumes, firewalls and SSH keys.",[80,118,119,122],{},[95,120,121],{},"Read-only",[95,123,124],{},"Sees everything in the project and changes nothing.",[14,126,127],{},"A project always keeps at least one owner. When someone is demoted below admin or removed, their API tokens and pending invites are revoked.",[18,129,131],{"id":130},"invites","Invites",[14,133,134,135,138,139,142],{},"On ",[52,136,137],{},"Members",", choose ",[52,140,141],{},"Invite",", enter an email address and pick a role. The invite link is shown once, so copy it. If the panel has SMTP set up, Nebla also emails it.",[57,144,145,152,155],{},[60,146,147,148,151],{},"Links expire after 7 days. ",[52,149,150],{},"Pending invites"," lists them, with a Revoke button.",[60,153,154],{},"The person accepting must be signed in with the invited email address.",[60,156,157],{},"Someone without an account can create one from the invite when open sign-up is on, or when a panel admin sent the invite.",[18,159,161],{"id":160},"ssh-keys","SSH keys",[14,163,134,164,138,166,169,170,173],{},[52,165,161],{},[52,167,168],{},"Add SSH key"," and paste one public key line. Ed25519, RSA, ECDSA and security-key (",[26,171,172],{},"sk-",") keys are accepted. The name defaults to the key's comment. Each key and name is unique within a project.",[14,175,176,177,182],{},"Pick keys when you ",[178,179,181],"a",{"href":180},"\u002Fdocs\u002Fservers#create-a-server","create a server",". Cloud-init installs them for the image's default user.",[18,184,186],{"id":185},"api-tokens","API tokens",[14,188,189,190,192,193,196,197,200],{},"Owners and admins manage tokens on ",[52,191,186],{},". A token belongs to one project and is either ",[52,194,195],{},"Read"," or ",[52,198,199],{},"Read and write",".",[57,202,203,210,213,216],{},[60,204,205,206,209],{},"The token starts with ",[26,207,208],{},"nb_"," and is shown once, when you create it. Nebla stores only a hash.",[60,211,212],{},"Tokens don't expire. Revoke one and anything using it stops working straight away.",[60,214,215],{},"The list shows when each token was last used.",[60,217,218],{},"A token reaches only that project's resources: servers, volumes, firewalls, SSH keys, actions, and the locations, images and server types the project can use.",[14,220,221,222,226,227,231],{},"Use a token with the ",[178,223,225],{"href":224},"\u002Fdocs\u002Fcli","CLI"," or the ",[178,228,230],{"href":229},"\u002Fdocs\u002Fapi","API",". Requests are limited to 3600 an hour per token, with bursts of up to 100.",[18,233,235],{"id":234},"your-account","Your account",[14,237,238,241],{},[52,239,240],{},"Account settings"," holds your name, your password and your sign-in methods. Your email address can't be changed there.",[57,243,244,250,256],{},[60,245,246,249],{},[52,247,248],{},"Password."," At least 10 characters. Changing it signs out your other sessions.",[60,251,252,255],{},[52,253,254],{},"Two-factor login."," Turn on TOTP with your password, an authenticator app and a 6-digit code. Turning it off needs a code and your password.",[60,257,258,261],{},[52,259,260],{},"Passkeys."," Add up to 10. Signing in with a passkey skips the two-factor code. Passkeys need the panel on https with a domain name. Removing one signs out your other devices.",[14,263,264],{},"If you lose your second factor, a panel admin can reset two-factor login and remove passkeys from your account.",{"title":266,"searchDepth":267,"depth":267,"links":268},"",2,[269,270,271,272,273,274],{"id":20,"depth":267,"text":21},{"id":71,"depth":267,"text":72},{"id":130,"depth":267,"text":131},{"id":160,"depth":267,"text":161},{"id":185,"depth":267,"text":186},{"id":234,"depth":267,"text":235},"Projects, member roles, invites, SSH keys, API tokens, and signing in with passwords, two-factor codes and passkeys.","md","Use Nebla",{},true,"\u002Fdocs\u002Fprojects",{"title":5,"description":275},"docs\u002F04.projects","piCRmfKPAOXkPQvAH7iRQ0iVPWY7kM_K13J539NW_L8",[285,290,294,298,302,303,307,311,315,318,320],{"path":286,"title":287,"group":288,"stem":289},"\u002Fdocs","Overview","Get started","docs\u002F00.index",{"path":291,"title":292,"group":288,"stem":293},"\u002Fdocs\u002Finstall","Install","docs\u002F01.install",{"path":295,"title":296,"group":288,"stem":297},"\u002Fdocs\u002Fproxmox","Connect Proxmox","docs\u002F02.proxmox",{"path":299,"title":300,"group":288,"stem":301},"\u002Fdocs\u002Fadmin","Set up the panel","docs\u002F03.admin",{"path":280,"title":5,"group":277,"stem":282},{"path":304,"title":305,"group":277,"stem":306},"\u002Fdocs\u002Fservers","Servers","docs\u002F05.servers",{"path":308,"title":309,"group":277,"stem":310},"\u002Fdocs\u002Fvolumes","Volumes","docs\u002F06.volumes",{"path":312,"title":313,"group":277,"stem":314},"\u002Fdocs\u002Ffirewalls","Firewalls","docs\u002F07.firewalls",{"path":224,"title":225,"group":316,"stem":317},"Reference","docs\u002F08.cli",{"path":229,"title":230,"group":316,"stem":319},"docs\u002F09.api",{"path":321,"title":322,"group":316,"stem":323},"\u002Fdocs\u002Ftroubleshooting","Troubleshooting","docs\u002F10.troubleshooting",1795243967229]