[{"data":1,"prerenderedAt":1225},["ShallowReactive",2],{"i-lucide:search":3,"i-lucide:github":8,"i-lucide:sun":11,"i-lucide:globe":13,"i-lucide:menu":15,"i-lucide:chevron-down":17,"i-lucide:map-pin":19,"docs-navigation-en":21,"docs-en-/docs/accounts":113,"docs-headings-en":894,"i-lucide:book-open":1191,"i-lucide:download":1193,"i-lucide:compass":1195,"i-lucide:arrow-up-circle":1197,"i-lucide:layers":1199,"i-lucide:users":1201,"i-lucide:plug":1203,"i-lucide:circle-alert":1205,"i-lucide:lock":1207,"i-lucide:database":1209,"i-lucide:folder-sync":1211,"i-lucide:life-buoy":1213,"i-lucide:shield-check":1215,"i-lucide:archive-restore":1217,"i-lucide:activity":1219,"i-lucide:wrench":1221,"i-lucide:link":1223},{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":7},0,24,false,"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"m21 21l-4.34-4.34\"/>\u003Ccircle cx=\"11\" cy=\"11\" r=\"8\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":9,"hidden":10},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M15 22v-4a4.8 4.8 0 0 0-1-3.5c3 0 6-2 6-5.5c.08-1.25-.27-2.48-1-3.5c.28-1.15.28-2.35 0-3.5c0 0-1 0-3 1.5c-2.64-.5-5.36-.5-8 0C6 2 5 2 5 2c-.3 1.15-.3 2.35 0 3.5A5.4 5.4 0 0 0 4 9c0 3.5 3 5.5 6 5.5c-.39.49-.68 1.05-.85 1.65S8.93 17.38 9 18v4\"/>\u003Cpath d=\"M9 18c-4.51 2-5-2-7-2\"/>\u003C/g>",true,{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":12},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"4\"/>\u003Cpath d=\"M12 2v2m0 16v2M4.93 4.93l1.41 1.41m11.32 11.32l1.41 1.41M2 12h2m16 0h2M6.34 17.66l-1.41 1.41M19.07 4.93l-1.41 1.41\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":14},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"/>\u003Cpath d=\"M12 2a14.5 14.5 0 0 0 0 20a14.5 14.5 0 0 0 0-20M2 12h20\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":16},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M4 5h16M4 12h16M4 19h16\"/>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":18},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m6 9l6 6l6-6\"/>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":20},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M20 10c0 4.993-5.539 10.193-7.399 11.799a1 1 0 0 1-1.202 0C9.539 20.193 4 14.993 4 10a8 8 0 0 1 16 0\"/>\u003Ccircle cx=\"12\" cy=\"10\" r=\"3\"/>\u003C/g>",[22,45],{"section":23,"items":24},"Getting started",[25,30,35,40],{"title":26,"path":27,"order":28,"icon":29},"Introduction","/docs",1,"lucide:book-open",{"title":31,"path":32,"order":33,"icon":34},"Installation","/docs/installation",2,"lucide:download",{"title":36,"path":37,"order":38,"icon":39},"Finding your way around the panel","/docs/panel-interface",2.5,"lucide:compass",{"title":41,"path":42,"order":43,"icon":44},"Upgrading Maran","/docs/upgrade",2.7,"lucide:arrow-up-circle",{"section":46,"items":47},"How it works",[48,53,58,63,68,73,78,83,88,93,98,103,108],{"title":49,"path":50,"order":51,"icon":52},"How it is built","/docs/architecture",3,"lucide:layers",{"title":54,"path":55,"order":56,"icon":57},"Hosting accounts","/docs/accounts",4,"lucide:users",{"title":59,"path":60,"order":61,"icon":62},"Websites and PHP","/docs/websites",5,"lucide:globe",{"title":64,"path":65,"order":66,"icon":67},"The provisioning API","/docs/api",6,"lucide:plug",{"title":69,"path":70,"order":71,"icon":72},"API error codes","/docs/api-errors",6.5,"lucide:circle-alert",{"title":74,"path":75,"order":76,"icon":77},"SSL certificates","/docs/ssl",7,"lucide:lock",{"title":79,"path":80,"order":81,"icon":82},"Databases","/docs/databases",8,"lucide:database",{"title":84,"path":85,"order":86,"icon":87},"File transfer and backups","/docs/file-transfer",9,"lucide:folder-sync",{"title":89,"path":90,"order":91,"icon":92},"Recovery and diagnostics","/docs/recovery",10,"lucide:life-buoy",{"title":94,"path":95,"order":96,"icon":97},"Panel certificate","/docs/panel-certificate",11,"lucide:shield-check",{"title":99,"path":100,"order":101,"icon":102},"Panel backup and restore","/docs/panel-backup",12,"lucide:archive-restore",{"title":104,"path":105,"order":106,"icon":107},"Dashboard and monitoring","/docs/monitoring",13,"lucide:activity",{"title":109,"path":110,"order":111,"icon":112},"Troubleshooting","/docs/troubleshooting",14,"lucide:wrench",{"doc":114,"isFallback":6},{"id":115,"title":54,"body":116,"description":885,"extension":886,"icon":57,"meta":887,"navigation":10,"order":56,"path":888,"rawbody":889,"section":46,"seo":890,"seoTitle":891,"stem":892,"__hash__":893},"docsEn/en/docs/accounts.md",{"type":117,"value":118,"toc":869},"minimark",[119,128,131,136,139,157,160,164,171,219,222,226,229,232,235,238,241,249,252,256,259,307,314,318,328,354,357,397,401,412,440,444,451,454,586,590,602,606,617,664,668,675,695,702,705,712,715,737,741,752,762,766,797,843,847,862],[120,121,122,123,127],"p",{},"A hosting account is a ",[124,125,126],"strong",{},"system user"," on the server, with its own uid, its own home directory and\nthe disk quota its plan carries. It is more than a row in a table that the panel interprets.\nEverything a customer owns (their sites, their files, their php-fpm pool) runs as that user.",[120,129,130],{},"This matters because the kernel and the filesystem enforce the boundary between two customers. The\napplication does not have to remember to add a condition to every query. An application that\nforgets leaks data, and a filesystem permission never forgets.",[132,133,135],"h2",{"id":134},"what-creating-one-does","What creating one does",[120,137,138],{},"The panel asks the agent, and the agent does the work on the host:",[140,141,142,146,149],"ol",{},[143,144,145],"li",{},"Creates the system user and its home directory.",[143,147,148],{},"Applies the plan's disk quota to it.",[143,150,151,152,156],{},"Group-owns the home by the web server's group at mode ",[153,154,155],"code",{},"0750",", so the server can traverse into a\ndocument root without the home being readable by every other local user.",[120,158,159],{},"Only then does the database row appear. The agent acts first and the row follows, so the panel never\nclaims an account the server does not have. If the host refuses, there is no row to reconcile later.",[132,161,163],{"id":162},"the-new-account-form","The new account form",[120,165,166,167,170],{},"Administrators create an account under ",[124,168,169],{},"Accounts → New account",". The form asks for:",[172,173,174,187,201,207,213],"ul",{},[143,175,176,179,180,183,184,186],{},[124,177,178],{},"Primary domain",", entered without ",[153,181,182],{},"www.",". The panel refuses a primary domain that starts with\n",[153,185,182],{},".",[143,188,189,192,193,196,197,200],{},[124,190,191],{},"Username",", the account's system user name. It is filled in from the domain as you type\n(",[153,194,195],{},"www.my-shop.example.com"," suggests ",[153,198,199],{},"myshop",") until you change it yourself. It must be 3 to 30\nlowercase letters, digits or underscores, and start with a letter.",[143,202,203,206],{},[124,204,205],{},"Plan",", whose disk quota, counts and CPU, memory and process limits bound the account.",[143,208,209,212],{},[124,210,211],{},"Owner email",", where the owner's invitation goes.",[143,214,215,218],{},[124,216,217],{},"Owner language",", chosen from the languages the panel ships text in (English, Russian and\nArmenian), each named in itself. There is nothing to type, and the server refuses any other value.\nIt starts as your own interface language. The owner's invitation is written in it, both when the\naccount is created and every time the invitation is resent, whatever language the administrator\nwho sends it uses.",[120,220,221],{},"A panel beside the form lists what creation makes on the server. The owner sets their own password\nfrom the invitation, so the administrator never knows it. The server checks every field again,\nwhatever the form allowed through.",[132,223,225],{"id":224},"suspension-is-a-state-not-a-deletion","Suspension is a state, not a deletion",[120,227,228],{},"Suspending stops the sites and the logins and leaves everything else where it is. Reactivating puts\nit back as it was. A billing system that suspends for non-payment and reactivates on payment needs\nexactly this. A panel that could only delete would turn every lapsed invoice into data loss.",[120,230,231],{},"Suspension also closes the panel for that account, and only for that account. Everyone who acts for\nit, the owner and the people the owner added, is refused at sign-in, on refresh and when switching to\nit, and the sessions speaking for it end. That includes a person who was invited and has not accepted\nyet: if they accept while the account is suspended, they still cannot sign in. Invited members of a\nsuspended account are refused both at sign-in and on every API call made for it.",[120,233,234],{},"A sign-in token issued before the suspension stops working too. Every request it makes for that\naccount is answered with \"This account is suspended, so it cannot be used until it is resumed.\"\n(409), so the block does not wait for the next sign-in.",[120,236,237],{},"A person who owns two accounts keeps working in the other one. The suspended account leaves their\naccount selector, and switching to it is refused with the same message. Only a person whose every\naccount is suspended is refused at sign-in, with the same answer as a wrong password. Reactivating\nthe account lets them back in.",[120,239,240],{},"The panel checks the server afterwards, both when suspending and when reactivating. It compares what\neach of the account's sites actually serves with the suspension page. If it cannot make that\ncomparison for a site, because the site's virtual host file cannot be read or parsed, the request is\nrefused and nothing is changed:",[172,242,243,246],{},[143,244,245],{},"Suspending answers \"The account was not suspended: the server could not be observed to have\nstopped it. Nothing has been changed; please try again.\"",[143,247,248],{},"Reactivating answers \"The account was not reactivated: the server could not be observed to have\nstarted it again. Nothing has been changed; please try again.\"",[120,250,251],{},"The panel will not claim a state it could not see. Open the account's sites, find the one with a\ndamaged or unreadable configuration, repair it, then repeat the request. The audit journal records\nno change, because none was made.",[132,253,255],{"id":254},"deleting-removes-what-the-account-left-behind","Deleting removes what the account left behind",[120,257,258],{},"Many panels leave orphans behind when they delete an account. Here, these go before the system user does:",[172,260,261,264,267,270,280,287,290,293],{},[143,262,263],{},"its databases and their users,",[143,265,266],{},"its file transfer logins,",[143,268,269],{},"its jail and the jail's mount unit,",[143,271,272,273,276,277,279],{},"its queued ",[153,274,275],{},"at"," jobs, where ",[153,278,275],{}," is installed,",[143,281,282,283,286],{},"a lingering session manager (",[153,284,285],{},"systemd --user","), where the host runs systemd,",[143,288,289],{},"its running processes: every process the account owns is ended, and the deletion checks that none is left,",[143,291,292],{},"its shared memory, message queues and semaphores,",[143,294,295,296,299,300,299,303,306],{},"its files left in shared temporary directories (",[153,297,298],{},"/tmp",", ",[153,301,302],{},"/var/tmp",[153,304,305],{},"/dev/shm","), outside the home.",[120,308,309,310,313],{},"A failure in any of that ",[124,311,312],{},"aborts the deletion",". The processes, the shared memory and the temporary\nfiles go last, just before the user. A temporary directory holding another owner's files is never\nemptied: the deletion stops and says so. If a process survives several rounds of being killed, the\nsystem user is not removed and the panel reports a system failure. Running the deletion again\nfinishes it once the process is gone. Processes that have already exited and only await collection\n(zombies) are ignored. An account re-created under the same name afterwards inherits nothing: no\ndatabase, no login, no password and no running process.",[132,315,317],{"id":316},"plans","Plans",[120,319,320,321,324,325,327],{},"A plan is the package an account is created on: a name and the limits every account on it lives\nwithin. Administrators manage plans under ",[124,322,323],{},"Accounts › Plans"," in the panel's navigation, where a\nplan can be created, edited and deleted. Customers never see this page, only the limits of their own\nplan.\nWhen an administrator creates an account, its plan is chosen in the ",[124,326,205],{}," field, which searches\nthe server's plans as you type.",[172,329,330,336,342,348],{},[143,331,332,335],{},[124,333,334],{},"Disk quota"," is the space the account's home may use, in megabytes. The kernel enforces it.",[143,337,338,341],{},[124,339,340],{},"Sites, databases and SFTP logins"," are the most of each an account may have, and each must be at\nleast 1.",[143,343,344,347],{},[124,345,346],{},"FTPS logins and cron entries"," work the same way, except that 0 is allowed and means the plan\nincludes none.",[143,349,350,353],{},[124,351,352],{},"PHP workers per pool"," is the worker budget of the account's php-fpm pool.",[120,355,356],{},"Some rules are worth knowing before you edit one:",[172,358,359,373,379,385,391],{},[143,360,361,364,365,368,369,372],{},[124,362,363],{},"Names are unique",", and case does not count: ",[153,366,367],{},"Business"," and ",[153,370,371],{},"business"," are the same name, and\nthe panel refuses the second.",[143,374,375,378],{},[124,376,377],{},"A plan in use cannot be deleted."," While any account is on it the deletion is refused and\nnothing changes; move those accounts to another plan or delete them first.",[143,380,381,384],{},[124,382,383],{},"Editing a plan reaches the accounts already on it."," A changed disk quota is pushed to every\nexisting account.",[143,386,387,390],{},[124,388,389],{},"A quota cannot be lowered below any account's usage."," The panel measures every account on the\nplan first; if one is using more than the new figure, the whole edit is refused and no account is\ntouched.",[143,392,393,396],{},[124,394,395],{},"The count limits only gate new things."," Lowering sites or databases does not remove what an\naccount already has. It only stops the account from adding more until it is back under the limit.",[132,398,400],{"id":399},"plan-features","Plan features",[120,402,403,404,407,408,411],{},"Beside its limits, a plan says which features its accounts have. On ",[124,405,406],{},"Plans → New plan"," and the edit\nform, a ",[124,409,410],{},"Features"," group has one checkbox per feature: Mail, DNS, Databases, Scheduled tasks (cron),\nFile transfer (SFTP and FTPS), Backups, Websites, SSL certificates, Background tasks and PHP versions.\nA new plan starts with all of them ticked. Plans that existed before keep all of them, including\nthe last four, which those plans included implicitly before they could be ticked.",[172,413,414,420,426,432,437],{},[143,415,416,419],{},[124,417,418],{},"A change reaches every account on the plan"," on its next request, and is audited as a plan update\nwith the features before and after.",[143,421,422,425],{},[124,423,424],{},"The customer's menu follows the plan."," An item for a feature the plan lacks is hidden, and a\nsection disappears when all of its items are hidden.",[143,427,428,431],{},[124,429,430],{},"The panel refuses the request as well."," A direct request for databases, scheduled tasks, file\ntransfer, backups, websites, certificates, background tasks or a site's PHP version is answered\nwith 403 and \"This feature is not included in your plan\".",[143,433,434],{},[124,435,436],{},"A plan's features never restrict administrators.",[143,438,439],{},"Mail and DNS can be ticked, but they have no pages yet.",[132,441,443],{"id":442},"team-access-sub-users","Team access: sub-users",[120,445,446,447,450],{},"An account owner can give other people access to part of the account under ",[124,448,449],{},"My account → Sub-users",".\nThe owner invites a person with a login name, an e-mail address and the features to grant, can change\nthose features later, and can remove the person after a confirmation. The invitee receives a one-time\nlink by e-mail and sets their own password, so the owner never knows it.",[120,452,453],{},"Resending an invitation and offering a place to an existing login are not in 1.0.0-beta.4. They\narrive with the next release.",[172,455,456,462,468,478,484,501,539,545,559,577,580],{},[143,457,458,461],{},[124,459,460],{},"Grantable features"," are Mail, DNS, Databases, Cron, File transfer, Backups, Websites, SSL\ncertificates, Background tasks and PHP versions, and a feature must also be in the account's plan.\nA member holding none of them reaches none of those areas. Switching a site's PHP version needs\nPHP versions in addition to Websites.",[143,463,464,467],{},[124,465,466],{},"Changes apply on the person's next request."," Removal takes effect at once everywhere. The panel\nchecks on every request that the person still belongs to the account, so a removed person's\nexisting sign-in stops working immediately instead of at its expiry.",[143,469,470,473,474,477],{},[124,471,472],{},"Action needed after upgrading: re-grant Websites, SSL certificates, Background tasks and PHP\nversions."," People who were invited before this was gated keep the features they were given but do\nnot receive these four, so until the owner grants them under ",[124,475,476],{},"Sub-users → Change features"," those\nmembers lose access to the sites, certificates, tasks and PHP settings they could reach before.",[143,479,480,483],{},[124,481,482],{},"Only the owner manages the team."," Members and administrators are refused.",[143,485,486,489,490,493,494,497,498,186],{},[124,487,488],{},"A pending invitation can be resent."," For a person who has not accepted yet, ",[124,491,492],{},"Resend invitation","\nin the list sends a new e-mail to the address already stored on that login, never to one typed in\nthe request. The earlier link stops working at once, so only one link is live. Once the person has\naccepted, there is nothing to resend and the panel answers ",[153,495,496],{},"SubUserNotPending"," (409). Resending\ncounts against the sending limit below and is audited as ",[124,499,500],{},"Sub-user invitation resent",[143,502,503,506,507,510,511,514,515,518,519,522,523,526,527,530,531,534,535,538],{},[124,504,505],{},"A login that already exists can be offered a place."," Under ",[124,508,509],{},"Add an existing login",", enter the\nlogin name or e-mail address and the features to offer. The person is not added yet: they get an\ne-mail with no link in it, and an invitation card appears on their ",[124,512,513],{},"My account"," page the next\ntime they sign in, where they ",[124,516,517],{},"Accept"," or ",[124,520,521],{},"Decline",". They join with exactly the features\noffered, and only if they accept. An offer stays open for 14 days, shows in your list as ",[124,524,525],{},"Offer\nsent",", and ",[124,528,529],{},"Cancel offer"," withdraws it. It can only go to an active customer login that is not\nalready on the team, and only while your account is active. As with an invitation, the panel gives\nthe same answer whether or not that login exists, and the outcome is recorded for the administrator\nin the audit journal. Accepting is refused with ",[153,532,533],{},"MembershipOfferAccountSuspended"," (409) while the\naccount is suspended, and an offer that is gone, expired or already answered is\n",[153,536,537],{},"MembershipOfferNotFound"," (404). Offers count towards the team limit below, and an administrator\nviewing as the person cannot accept or decline for them.",[143,540,541,544],{},[124,542,543],{},"The panel does not say whether a login name or address was already taken."," An invitation\nrequest always gets the same answer (accepted, with the name and address you typed), whether or\nnot the name or address already belongs to a login on this server. If it was free, the person\nappears in the list as Invited and receives the e-mail. If it was taken, nothing is created and\nnothing is mailed. An invitation never adds an existing login to your account; use an offer for that. The refusal is recorded for\nthe administrator in the audit journal.",[143,546,547,550,551,554,555,558],{},[124,548,549],{},"There is a limit on the team."," One account may hold 25 sub-users, invited or active, unless the\nadministrator sets another number (",[153,552,553],{},"SubUsers__MaxPerAccount",", 1 to 1000). Past it, the panel\nanswers with the code ",[153,556,557],{},"SubUserLimitReached"," until you remove someone.",[143,560,561,564,565,568,569,572,573,576],{},[124,562,563],{},"Sending invitations has its own rate limit",", per account and separate from accepting one: 20\ninvitations an hour by default (",[153,566,567],{},"RateLimiting__InvitationSendMaxRequests"," and\n",[153,570,571],{},"RateLimiting__InvitationSendWindowSeconds","). Further requests are answered with 429 and a\n",[153,574,575],{},"Retry-After"," header.",[143,578,579],{},"Inviting, changing features and removing are each written to the audit journal.",[143,581,582,585],{},[124,583,584],{},"The list shows each person's state",": Active, Invited or Offer sent. It cannot show a suspension, because\nnobody can sign in to a suspended account to read the list. No invitation can be issued while the\naccount is suspended, so reactivate it first.",[132,587,589],{"id":588},"more-than-one-account-per-login","More than one account per login",[120,591,592,593,597,598,601],{},"One login can own several accounts. A customer with two or more picks the active one from the account\nselector in the header, as described in ",[594,595,596],"a",{"href":37},"finding your way around the panel",".\nSign-in starts on the oldest account, every switch is audited as ",[124,599,600],{},"Switched active account",", and\nswitching to an account the login does not belong to is refused as not found.",[132,603,605],{"id":604},"viewing-as-an-account","Viewing as an account",[120,607,608,609,612,613,616],{},"An administrator can open ",[124,610,611],{},"View as this account"," on an account's page. The panel then shows the\ncustomer panel as that account's login, with a banner on every page: \"You are viewing as the account name\nand its login\". A ",[124,614,615],{},"Back"," button returns to the administrator's own session, on the account's\npage. Viewing ends by itself after 15 minutes.",[172,618,619,633,646,652,658],{},[143,620,621,624,625,628,629,632],{},[124,622,623],{},"Viewing is read-only apart from a short allow-list."," Everything the customer can read, you can\nread. Anything that changes something is refused unless it is on the list of safe changes, and an\naction nobody classified is refused by default. The safe changes are pinning and unpinning a page\nand ending the view. Each of these is refused, because each would leave something behind that\noutlives the 15 minutes: creating an SFTP or FTP login, a database or a cron entry; running a cron\njob; creating or deleting a site, a certificate or a backup; changing the password, two-factor\nsettings, sessions or sub-users; switching accounts; and starting a second view. A refused action\nanswers ",[153,626,627],{},"403"," with the code ",[153,630,631],{},"HostViewAsNotAllowed",". To make such a change, end the view and do it\nas the administrator.",[143,634,635,638,639,568,642,645],{},[124,636,637],{},"Audited both ways."," Starting and stopping are recorded as ",[124,640,641],{},"Started viewing as an account",[124,643,644],{},"Stopped viewing as an account",", with the administrator as the actor. Actions taken while viewing\nrecord the administrator as the impersonator.",[143,647,648,651],{},[124,649,650],{},"The customer can see it."," The view appears on their sessions screen.",[143,653,654,657],{},[124,655,656],{},"Viewing as a reseller, and a reseller viewing its own accounts"," (not in 1.0.0-beta.4; arrives with the next\nrelease). An administrator will be able to view as a reseller from the reseller's page, and a reseller as the owner\nof one of its own accounts, never of another reseller's. Each is a single step: a view cannot start another view.",[143,659,660,663],{},[124,661,662],{},"The audit screen shows who was viewing"," (from the next release; 1.0.0-beta.4 does not show it). An entry written while an administrator viewed the\npanel as a customer prints \"via\" and the administrator's name under the actor, on the audit list\nand in the dashboard's recent activity, and the audit search also finds the administrator's name.",[132,665,667],{"id":666},"runtime-limits","Runtime limits",[120,669,670,671,674],{},"Beside the disk quota and the counts, a plan carries three ceilings on what each account on it may\nuse at once. Each is either a figure or ",[124,672,673],{},"No limit",":",[172,676,677,683,689],{},[143,678,679,682],{},[124,680,681],{},"CPU (% of one core)",": a share of one core. 50 is half a core, 200 is two whole cores.",[143,684,685,688],{},[124,686,687],{},"Memory (MB)",": the most memory the account's processes may hold together.",[143,690,691,694],{},[124,692,693],{},"Processes",": the most processes and threads the account may run at once.",[120,696,697,698,701],{},"The agent writes them onto the account's systemd slice, ",[153,699,700],{},"user-\u003Cuid>.slice",". It does so when the\naccount is created, when a plan's ceilings change (for every account on it), and when an account\nmoves to a plan with other ceilings. A new account always gets all three, \"No limit\" included, so an\naccount that reuses an old uid never inherits its predecessor's ceilings. If the server refuses\nthem, the account is not created.",[120,703,704],{},"A lowered ceiling is applied immediately. CPU is throttled, the next process past the cap is\nrefused, and memory above a lowered cap is reclaimed from the account, which can end the account's\nown processes. Plans that existed before this feature are \"No limit\" on all three.",[120,706,707,708,711],{},"In the provisioning API a ceiling is ",[153,709,710],{},"{\"kind\": \"limited\" | \"unlimited\", \"maximum\": n}",". A missing\nceiling, a limited zero and an unlimited ceiling with a figure are refused with 400.",[120,713,714],{},"What the slice covers, and what it does not:",[172,716,717,723,731],{},[143,718,719,722],{},[124,720,721],{},"Covered:"," the account's SSH and SFTP sessions and everything started under them.",[143,724,725,728,729,186],{},[124,726,727],{},"Not covered: PHP workers."," Each PHP version runs one php-fpm master as a system service, and\nevery pool's workers belong to it, not to the account's slice. A busy PHP site is bounded only by\n",[124,730,352],{},[143,732,733,736],{},[124,734,735],{},"Not covered: cron jobs on the Debian family."," Debian's cron PAM stack registers no session, so\na job runs in the cron service's cgroup. On the RHEL family cron jobs land in the user's slice,\naccording to the distribution's shipped PAM files; this has not been verified on a host yet.",[132,738,740],{"id":739},"running-a-scheduled-task-now","Running a scheduled task now",[120,742,743,744,747,748,751],{},"A cron entry can be started by hand from ",[124,745,746],{},"Scheduled tasks → Run now",", to check that it works\nwithout waiting for its schedule. It runs as the account's own user, inside the account's resource\nslice, so the plan's CPU, memory and process limits apply, with the crontab's environment. It is\nstopped after two minutes, and stopped without keeping its output if it prints more than 64 KiB on\none stream. When a run reaches the output limit, the server stops the job's own unit and waits for\nconfirmation before it reports the run as stopped. If the stop cannot be confirmed, the run is not\nreported as stopped, because the job may still be running until the server's own runtime ceiling\nends it. The request is answered with ",[153,749,750],{},"CronRunNotStopped"," (500) instead, which says the job may\nstill be running and that you should check it before running it again. The result shows how the run\nended, its exit code, how long it took and both output streams.",[120,753,754,757,758,761],{},[124,755,756],{},"Run history"," keeps the last twenty runs started this way for each entry, searchable in their\noutput and filterable by outcome. Runs that cron starts on the schedule are not in it; the last one\nis still under ",[124,759,760],{},"Last run",". A disabled entry can be run by hand; a suspended account's entries\ncannot.",[132,763,765],{"id":764},"what-a-customer-sees","What a customer sees",[120,767,768,769,299,772,299,775,299,778,299,781,783,784,299,787,299,790,793,794,796],{},"A customer signs in to their own account and sees nothing that belongs to the server. The menu\nhas nine sections: ",[124,770,771],{},"System status",[124,773,774],{},"Sites and domains",[124,776,777],{},"DNS",[124,779,780],{},"Mail",[124,782,79],{},",\n",[124,785,786],{},"Files and access",[124,788,789],{},"Backups",[124,791,792],{},"Activity"," (background tasks) and ",[124,795,513],{}," (profile,\ntwo-step verification and sessions). A section with more than one page opens as a submenu.",[172,798,799,805,811,821],{},[143,800,801,804],{},[124,802,803],{},"Pages that are not built yet are shown, disabled."," They are greyed out, marked \"Coming soon\"\nand cannot be opened, so you can see the shape of the panel before every page exists.",[143,806,807,810],{},[124,808,809],{},"A feature the plan does not include is hidden."," The menu follows the plan's features (see\nPlan features above), and an item for a feature the plan lacks is not offered.",[143,812,813,816,817,820],{},[124,814,815],{},"At a plan limit, the create action is replaced by the reason."," When an account holds as many\nsites, databases, SFTP logins, FTPS logins or cron entries as its plan allows, the screen says so\ninstead of offering another, using the same counts as the account's ",[124,818,819],{},"Resources"," card. The\npanel refuses the create on its own as well. The menu and the screens are only advice, and the\nserver enforces the limit.",[143,822,823,826,827,299,830,299,833,368,835,838,839,842],{},[124,824,825],{},"On a phone",", the bottom bar holds ",[124,828,829],{},"Home",[124,831,832],{},"Sites",[124,834,780],{},[124,836,837],{},"Account",", with\n",[124,840,841],{},"More"," opening the full menu. Mail is disabled until mail hosting lands.",[132,844,846],{"id":845},"one-limitation-worth-knowing","One limitation worth knowing",[120,848,849,850,853,854,857,858,861],{},"An account created before 1.0.0-beta.1 does not have the group ownership on its home that lets the\nweb server reach a document root, and there is no repair command. ",[153,851,852],{},"chgrp www-data /home/\u003Caccount>","\nfixes one by hand, ",[153,855,856],{},"nginx"," instead of ",[153,859,860],{},"www-data"," on the RHEL family.",[120,863,864,865,868],{},"Every action above is written to the ",[594,866,867],{"href":50},"audit journal",", which is append-only.",{"title":870,"searchDepth":33,"depth":33,"links":871},"",[872,873,874,875,876,877,878,879,880,881,882,883,884],{"id":134,"depth":33,"text":135},{"id":162,"depth":33,"text":163},{"id":224,"depth":33,"text":225},{"id":254,"depth":33,"text":255},{"id":316,"depth":33,"text":317},{"id":399,"depth":33,"text":400},{"id":442,"depth":33,"text":443},{"id":588,"depth":33,"text":589},{"id":604,"depth":33,"text":605},{"id":666,"depth":33,"text":667},{"id":739,"depth":33,"text":740},{"id":764,"depth":33,"text":765},{"id":845,"depth":33,"text":846},"What a hosting account is on a Maran server: a real Linux user with its own home, quota and limits, and what creating, suspending and deleting one does.","md",{},"/en/docs/accounts","---\ntitle: Hosting accounts\ndescription: 'What a hosting account is on a Maran server: a real Linux user with its own home, quota and limits, and what creating, suspending and deleting one does.'\nseoTitle: 'Hosting accounts, real Linux users'\nsection: How it works\norder: 4\nicon: lucide:users\n---\n\nA hosting account is a **system user** on the server, with its own uid, its own home directory and\nthe disk quota its plan carries. It is more than a row in a table that the panel interprets.\nEverything a customer owns (their sites, their files, their php-fpm pool) runs as that user.\n\nThis matters because the kernel and the filesystem enforce the boundary between two customers. The\napplication does not have to remember to add a condition to every query. An application that\nforgets leaks data, and a filesystem permission never forgets.\n\n## What creating one does\n\nThe panel asks the agent, and the agent does the work on the host:\n\n1. Creates the system user and its home directory.\n2. Applies the plan's disk quota to it.\n3. Group-owns the home by the web server's group at mode `0750`, so the server can traverse into a\n   document root without the home being readable by every other local user.\n\nOnly then does the database row appear. The agent acts first and the row follows, so the panel never\nclaims an account the server does not have. If the host refuses, there is no row to reconcile later.\n\n## The new account form\n\nAdministrators create an account under **Accounts → New account**. The form asks for:\n\n- **Primary domain**, entered without `www.`. The panel refuses a primary domain that starts with\n  `www.`.\n- **Username**, the account's system user name. It is filled in from the domain as you type\n  (`www.my-shop.example.com` suggests `myshop`) until you change it yourself. It must be 3 to 30\n  lowercase letters, digits or underscores, and start with a letter.\n- **Plan**, whose disk quota, counts and CPU, memory and process limits bound the account.\n- **Owner email**, where the owner's invitation goes.\n- **Owner language**, chosen from the languages the panel ships text in (English, Russian and\n  Armenian), each named in itself. There is nothing to type, and the server refuses any other value.\n  It starts as your own interface language. The owner's invitation is written in it, both when the\n  account is created and every time the invitation is resent, whatever language the administrator\n  who sends it uses.\n\nA panel beside the form lists what creation makes on the server. The owner sets their own password\nfrom the invitation, so the administrator never knows it. The server checks every field again,\nwhatever the form allowed through.\n\n## Suspension is a state, not a deletion\n\nSuspending stops the sites and the logins and leaves everything else where it is. Reactivating puts\nit back as it was. A billing system that suspends for non-payment and reactivates on payment needs\nexactly this. A panel that could only delete would turn every lapsed invoice into data loss.\n\nSuspension also closes the panel for that account, and only for that account. Everyone who acts for\nit, the owner and the people the owner added, is refused at sign-in, on refresh and when switching to\nit, and the sessions speaking for it end. That includes a person who was invited and has not accepted\nyet: if they accept while the account is suspended, they still cannot sign in. Invited members of a\nsuspended account are refused both at sign-in and on every API call made for it.\n\nA sign-in token issued before the suspension stops working too. Every request it makes for that\naccount is answered with \"This account is suspended, so it cannot be used until it is resumed.\"\n(409), so the block does not wait for the next sign-in.\n\nA person who owns two accounts keeps working in the other one. The suspended account leaves their\naccount selector, and switching to it is refused with the same message. Only a person whose every\naccount is suspended is refused at sign-in, with the same answer as a wrong password. Reactivating\nthe account lets them back in.\n\nThe panel checks the server afterwards, both when suspending and when reactivating. It compares what\neach of the account's sites actually serves with the suspension page. If it cannot make that\ncomparison for a site, because the site's virtual host file cannot be read or parsed, the request is\nrefused and nothing is changed:\n\n- Suspending answers \"The account was not suspended: the server could not be observed to have\n  stopped it. Nothing has been changed; please try again.\"\n- Reactivating answers \"The account was not reactivated: the server could not be observed to have\n  started it again. Nothing has been changed; please try again.\"\n\nThe panel will not claim a state it could not see. Open the account's sites, find the one with a\ndamaged or unreadable configuration, repair it, then repeat the request. The audit journal records\nno change, because none was made.\n\n## Deleting removes what the account left behind\n\nMany panels leave orphans behind when they delete an account. Here, these go before the system user does:\n\n- its databases and their users,\n- its file transfer logins,\n- its jail and the jail's mount unit,\n- its queued `at` jobs, where `at` is installed,\n- a lingering session manager (`systemd --user`), where the host runs systemd,\n- its running processes: every process the account owns is ended, and the deletion checks that none is left,\n- its shared memory, message queues and semaphores,\n- its files left in shared temporary directories (`/tmp`, `/var/tmp`, `/dev/shm`), outside the home.\n\nA failure in any of that **aborts the deletion**. The processes, the shared memory and the temporary\nfiles go last, just before the user. A temporary directory holding another owner's files is never\nemptied: the deletion stops and says so. If a process survives several rounds of being killed, the\nsystem user is not removed and the panel reports a system failure. Running the deletion again\nfinishes it once the process is gone. Processes that have already exited and only await collection\n(zombies) are ignored. An account re-created under the same name afterwards inherits nothing: no\ndatabase, no login, no password and no running process.\n\n## Plans\n\nA plan is the package an account is created on: a name and the limits every account on it lives\nwithin. Administrators manage plans under **Accounts › Plans** in the panel's navigation, where a\nplan can be created, edited and deleted. Customers never see this page, only the limits of their own\nplan.\nWhen an administrator creates an account, its plan is chosen in the **Plan** field, which searches\nthe server's plans as you type.\n\n- **Disk quota** is the space the account's home may use, in megabytes. The kernel enforces it.\n- **Sites, databases and SFTP logins** are the most of each an account may have, and each must be at\n  least 1.\n- **FTPS logins and cron entries** work the same way, except that 0 is allowed and means the plan\n  includes none.\n- **PHP workers per pool** is the worker budget of the account's php-fpm pool.\n\nSome rules are worth knowing before you edit one:\n\n- **Names are unique**, and case does not count: `Business` and `business` are the same name, and\n  the panel refuses the second.\n- **A plan in use cannot be deleted.** While any account is on it the deletion is refused and\n  nothing changes; move those accounts to another plan or delete them first.\n- **Editing a plan reaches the accounts already on it.** A changed disk quota is pushed to every\n  existing account.\n- **A quota cannot be lowered below any account's usage.** The panel measures every account on the\n  plan first; if one is using more than the new figure, the whole edit is refused and no account is\n  touched.\n- **The count limits only gate new things.** Lowering sites or databases does not remove what an\n  account already has. It only stops the account from adding more until it is back under the limit.\n\n## Plan features\n\nBeside its limits, a plan says which features its accounts have. On **Plans → New plan** and the edit\nform, a **Features** group has one checkbox per feature: Mail, DNS, Databases, Scheduled tasks (cron),\nFile transfer (SFTP and FTPS), Backups, Websites, SSL certificates, Background tasks and PHP versions.\nA new plan starts with all of them ticked. Plans that existed before keep all of them, including\nthe last four, which those plans included implicitly before they could be ticked.\n\n- **A change reaches every account on the plan** on its next request, and is audited as a plan update\n  with the features before and after.\n- **The customer's menu follows the plan.** An item for a feature the plan lacks is hidden, and a\n  section disappears when all of its items are hidden.\n- **The panel refuses the request as well.** A direct request for databases, scheduled tasks, file\n  transfer, backups, websites, certificates, background tasks or a site's PHP version is answered\n  with 403 and \"This feature is not included in your plan\".\n- **A plan's features never restrict administrators.**\n- Mail and DNS can be ticked, but they have no pages yet.\n\n## Team access: sub-users\n\nAn account owner can give other people access to part of the account under **My account → Sub-users**.\nThe owner invites a person with a login name, an e-mail address and the features to grant, can change\nthose features later, and can remove the person after a confirmation. The invitee receives a one-time\nlink by e-mail and sets their own password, so the owner never knows it.\n\nResending an invitation and offering a place to an existing login are not in 1.0.0-beta.4. They\narrive with the next release.\n\n- **Grantable features** are Mail, DNS, Databases, Cron, File transfer, Backups, Websites, SSL\n  certificates, Background tasks and PHP versions, and a feature must also be in the account's plan.\n  A member holding none of them reaches none of those areas. Switching a site's PHP version needs\n  PHP versions in addition to Websites.\n- **Changes apply on the person's next request.** Removal takes effect at once everywhere. The panel\n  checks on every request that the person still belongs to the account, so a removed person's\n  existing sign-in stops working immediately instead of at its expiry.\n- **Action needed after upgrading: re-grant Websites, SSL certificates, Background tasks and PHP\n  versions.** People who were invited before this was gated keep the features they were given but do\n  not receive these four, so until the owner grants them under **Sub-users → Change features** those\n  members lose access to the sites, certificates, tasks and PHP settings they could reach before.\n- **Only the owner manages the team.** Members and administrators are refused.\n- **A pending invitation can be resent.** For a person who has not accepted yet, **Resend invitation**\n  in the list sends a new e-mail to the address already stored on that login, never to one typed in\n  the request. The earlier link stops working at once, so only one link is live. Once the person has\n  accepted, there is nothing to resend and the panel answers `SubUserNotPending` (409). Resending\n  counts against the sending limit below and is audited as **Sub-user invitation resent**.\n- **A login that already exists can be offered a place.** Under **Add an existing login**, enter the\n  login name or e-mail address and the features to offer. The person is not added yet: they get an\n  e-mail with no link in it, and an invitation card appears on their **My account** page the next\n  time they sign in, where they **Accept** or **Decline**. They join with exactly the features\n  offered, and only if they accept. An offer stays open for 14 days, shows in your list as **Offer\n  sent**, and **Cancel offer** withdraws it. It can only go to an active customer login that is not\n  already on the team, and only while your account is active. As with an invitation, the panel gives\n  the same answer whether or not that login exists, and the outcome is recorded for the administrator\n  in the audit journal. Accepting is refused with `MembershipOfferAccountSuspended` (409) while the\n  account is suspended, and an offer that is gone, expired or already answered is\n  `MembershipOfferNotFound` (404). Offers count towards the team limit below, and an administrator\n  viewing as the person cannot accept or decline for them.\n- **The panel does not say whether a login name or address was already taken.** An invitation\n  request always gets the same answer (accepted, with the name and address you typed), whether or\n  not the name or address already belongs to a login on this server. If it was free, the person\n  appears in the list as Invited and receives the e-mail. If it was taken, nothing is created and\n  nothing is mailed. An invitation never adds an existing login to your account; use an offer for that. The refusal is recorded for\n  the administrator in the audit journal.\n- **There is a limit on the team.** One account may hold 25 sub-users, invited or active, unless the\n  administrator sets another number (`SubUsers__MaxPerAccount`, 1 to 1000). Past it, the panel\n  answers with the code `SubUserLimitReached` until you remove someone.\n- **Sending invitations has its own rate limit**, per account and separate from accepting one: 20\n  invitations an hour by default (`RateLimiting__InvitationSendMaxRequests` and\n  `RateLimiting__InvitationSendWindowSeconds`). Further requests are answered with 429 and a\n  `Retry-After` header.\n- Inviting, changing features and removing are each written to the audit journal.\n- **The list shows each person's state**: Active, Invited or Offer sent. It cannot show a suspension, because\n  nobody can sign in to a suspended account to read the list. No invitation can be issued while the\n  account is suspended, so reactivate it first.\n\n## More than one account per login\n\nOne login can own several accounts. A customer with two or more picks the active one from the account\nselector in the header, as described in [finding your way around the panel](/docs/panel-interface).\nSign-in starts on the oldest account, every switch is audited as **Switched active account**, and\nswitching to an account the login does not belong to is refused as not found.\n\n## Viewing as an account\n\nAn administrator can open **View as this account** on an account's page. The panel then shows the\ncustomer panel as that account's login, with a banner on every page: \"You are viewing as the account name\nand its login\". A **Back** button returns to the administrator's own session, on the account's\npage. Viewing ends by itself after 15 minutes.\n\n- **Viewing is read-only apart from a short allow-list.** Everything the customer can read, you can\n  read. Anything that changes something is refused unless it is on the list of safe changes, and an\n  action nobody classified is refused by default. The safe changes are pinning and unpinning a page\n  and ending the view. Each of these is refused, because each would leave something behind that\n  outlives the 15 minutes: creating an SFTP or FTP login, a database or a cron entry; running a cron\n  job; creating or deleting a site, a certificate or a backup; changing the password, two-factor\n  settings, sessions or sub-users; switching accounts; and starting a second view. A refused action\n  answers `403` with the code `HostViewAsNotAllowed`. To make such a change, end the view and do it\n  as the administrator.\n- **Audited both ways.** Starting and stopping are recorded as **Started viewing as an account** and\n  **Stopped viewing as an account**, with the administrator as the actor. Actions taken while viewing\n  record the administrator as the impersonator.\n- **The customer can see it.** The view appears on their sessions screen.\n- **Viewing as a reseller, and a reseller viewing its own accounts** (not in 1.0.0-beta.4; arrives with the next\n  release). An administrator will be able to view as a reseller from the reseller's page, and a reseller as the owner\n  of one of its own accounts, never of another reseller's. Each is a single step: a view cannot start another view.\n- **The audit screen shows who was viewing** (from the next release; 1.0.0-beta.4 does not show it). An entry written while an administrator viewed the\n  panel as a customer prints \"via\" and the administrator's name under the actor, on the audit list\n  and in the dashboard's recent activity, and the audit search also finds the administrator's name.\n\n## Runtime limits\n\nBeside the disk quota and the counts, a plan carries three ceilings on what each account on it may\nuse at once. Each is either a figure or **No limit**:\n\n- **CPU (% of one core)**: a share of one core. 50 is half a core, 200 is two whole cores.\n- **Memory (MB)**: the most memory the account's processes may hold together.\n- **Processes**: the most processes and threads the account may run at once.\n\nThe agent writes them onto the account's systemd slice, `user-\u003Cuid>.slice`. It does so when the\naccount is created, when a plan's ceilings change (for every account on it), and when an account\nmoves to a plan with other ceilings. A new account always gets all three, \"No limit\" included, so an\naccount that reuses an old uid never inherits its predecessor's ceilings. If the server refuses\nthem, the account is not created.\n\nA lowered ceiling is applied immediately. CPU is throttled, the next process past the cap is\nrefused, and memory above a lowered cap is reclaimed from the account, which can end the account's\nown processes. Plans that existed before this feature are \"No limit\" on all three.\n\nIn the provisioning API a ceiling is `{\"kind\": \"limited\" | \"unlimited\", \"maximum\": n}`. A missing\nceiling, a limited zero and an unlimited ceiling with a figure are refused with 400.\n\nWhat the slice covers, and what it does not:\n\n- **Covered:** the account's SSH and SFTP sessions and everything started under them.\n- **Not covered: PHP workers.** Each PHP version runs one php-fpm master as a system service, and\n  every pool's workers belong to it, not to the account's slice. A busy PHP site is bounded only by\n  **PHP workers per pool**.\n- **Not covered: cron jobs on the Debian family.** Debian's cron PAM stack registers no session, so\n  a job runs in the cron service's cgroup. On the RHEL family cron jobs land in the user's slice,\n  according to the distribution's shipped PAM files; this has not been verified on a host yet.\n\n## Running a scheduled task now\n\nA cron entry can be started by hand from **Scheduled tasks → Run now**, to check that it works\nwithout waiting for its schedule. It runs as the account's own user, inside the account's resource\nslice, so the plan's CPU, memory and process limits apply, with the crontab's environment. It is\nstopped after two minutes, and stopped without keeping its output if it prints more than 64 KiB on\none stream. When a run reaches the output limit, the server stops the job's own unit and waits for\nconfirmation before it reports the run as stopped. If the stop cannot be confirmed, the run is not\nreported as stopped, because the job may still be running until the server's own runtime ceiling\nends it. The request is answered with `CronRunNotStopped` (500) instead, which says the job may\nstill be running and that you should check it before running it again. The result shows how the run\nended, its exit code, how long it took and both output streams.\n\n**Run history** keeps the last twenty runs started this way for each entry, searchable in their\noutput and filterable by outcome. Runs that cron starts on the schedule are not in it; the last one\nis still under **Last run**. A disabled entry can be run by hand; a suspended account's entries\ncannot.\n\n## What a customer sees\n\nA customer signs in to their own account and sees nothing that belongs to the server. The menu\nhas nine sections: **System status**, **Sites and domains**, **DNS**, **Mail**, **Databases**,\n**Files and access**, **Backups**, **Activity** (background tasks) and **My account** (profile,\ntwo-step verification and sessions). A section with more than one page opens as a submenu.\n\n- **Pages that are not built yet are shown, disabled.** They are greyed out, marked \"Coming soon\"\n  and cannot be opened, so you can see the shape of the panel before every page exists.\n- **A feature the plan does not include is hidden.** The menu follows the plan's features (see\n  Plan features above), and an item for a feature the plan lacks is not offered.\n- **At a plan limit, the create action is replaced by the reason.** When an account holds as many\n  sites, databases, SFTP logins, FTPS logins or cron entries as its plan allows, the screen says so\n  instead of offering another, using the same counts as the account's **Resources** card. The\n  panel refuses the create on its own as well. The menu and the screens are only advice, and the\n  server enforces the limit.\n- **On a phone**, the bottom bar holds **Home**, **Sites**, **Mail** and **Account**, with\n  **More** opening the full menu. Mail is disabled until mail hosting lands.\n\n## One limitation worth knowing\n\nAn account created before 1.0.0-beta.1 does not have the group ownership on its home that lets the\nweb server reach a document root, and there is no repair command. `chgrp www-data /home/\u003Caccount>`\nfixes one by hand, `nginx` instead of `www-data` on the RHEL family.\n\nEvery action above is written to the [audit journal](/docs/architecture), which is append-only.\n",{"title":54,"description":885},"Hosting accounts, real Linux users","en/docs/accounts","Uo5yRoC8EnU4okmRa8g8bqOzakaJ6jzG5qFT99nrSjg",{"/docs/accounts":895,"/docs/api":909,"/docs/api-errors":934,"/docs/architecture":947,"/docs/databases":963,"/docs/file-transfer":976,"/docs":994,"/docs/installation":1007,"/docs/monitoring":1023,"/docs/panel-backup":1042,"/docs/panel-certificate":1061,"/docs/panel-interface":1080,"/docs/recovery":1109,"/docs/ssl":1134,"/docs/troubleshooting":1143,"/docs/upgrade":1156,"/docs/websites":1172},[896,897,898,899,900,901,902,903,904,905,906,907,908],{"title":135,"anchor":134},{"title":163,"anchor":162},{"title":225,"anchor":224},{"title":255,"anchor":254},{"title":317,"anchor":316},{"title":400,"anchor":399},{"title":443,"anchor":442},{"title":589,"anchor":588},{"title":605,"anchor":604},{"title":667,"anchor":666},{"title":740,"anchor":739},{"title":765,"anchor":764},{"title":846,"anchor":845},[910,913,916,919,922,925,928,931],{"title":911,"anchor":912},"A login, not a key yet","a-login-not-a-key-yet",{"title":914,"anchor":915},"The account lifecycle","the-account-lifecycle",{"title":917,"anchor":918},"Plan features, accounts and views","plan-features-accounts-and-views",{"title":920,"anchor":921},"Answers without a body","answers-without-a-body",{"title":923,"anchor":924},"Renamed response fields","renamed-response-fields",{"title":926,"anchor":927},"What it is not","what-it-is-not",{"title":929,"anchor":930},"Errors say what a caller may know","errors-say-what-a-caller-may-know",{"title":932,"anchor":933},"Every error code","every-error-code",[935,938,941,944],{"title":936,"anchor":937},"The status comes from the kind of failure","the-status-comes-from-the-kind-of-failure",{"title":939,"anchor":940},"Codes worth knowing first","codes-worth-knowing-first",{"title":942,"anchor":943},"A failed background task carries the same codes","a-failed-background-task-carries-the-same-codes",{"title":945,"anchor":946},"Every code","every-code",[948,951,954,957,960],{"title":949,"anchor":950},"The three processes","the-three-processes",{"title":952,"anchor":953},"The contract between them","the-contract-between-them",{"title":955,"anchor":956},"Writing a configuration file","writing-a-configuration-file",{"title":958,"anchor":959},"Isolation between accounts","isolation-between-accounts",{"title":961,"anchor":962},"What is deliberately absent","what-is-deliberately-absent",[964,967,970,973],{"title":965,"anchor":966},"Isolation is built, not assumed","isolation-is-built-not-assumed",{"title":968,"anchor":969},"The password is shown once","the-password-is-shown-once",{"title":971,"anchor":972},"Dropping is final","dropping-is-final",{"title":974,"anchor":975},"The grant repair, for hosts that ran an older build","the-grant-repair-for-hosts-that-ran-an-older-build",[977,980,983,986,989,991],{"title":978,"anchor":979},"Each login is jailed, and the jail is real","each-login-is-jailed-and-the-jail-is-real",{"title":981,"anchor":982},"Resetting or deleting a login ends its open sessions","resetting-or-deleting-a-login-ends-its-open-sessions",{"title":984,"anchor":985},"Public keys live outside the jail","public-keys-live-outside-the-jail",{"title":987,"anchor":988},"FTPS ships installed and switched off","ftps-ships-installed-and-switched-off",{"title":789,"anchor":990},"backups",{"title":992,"anchor":993},"What nothing re-checks","what-nothing-re-checks",[995,998,1001,1004],{"title":996,"anchor":997},"Three processes, and only one of them is root","three-processes-and-only-one-of-them-is-root",{"title":999,"anchor":1000},"What a hosting account is","what-a-hosting-account-is",{"title":1002,"anchor":1003},"No brokers, no sidecars","no-brokers-no-sidecars",{"title":1005,"anchor":1006},"Keyboard, screen readers and motion","keyboard-screen-readers-and-motion",[1008,1011,1014,1017,1020],{"title":1009,"anchor":1010},"Run the installer","run-the-installer",{"title":1012,"anchor":1013},"Installing without internet access","installing-without-internet-access",{"title":1015,"anchor":1016},"The first administrator","the-first-administrator",{"title":1018,"anchor":1019},"After the first sign-in","after-the-first-sign-in",{"title":1021,"anchor":1022},"Updates","updates",[1024,1027,1030,1033,1036,1039],{"title":1025,"anchor":1026},"What the dashboard shows","what-the-dashboard-shows",{"title":1028,"anchor":1029},"A part that could not be read says so","a-part-that-could-not-be-read-says-so",{"title":1031,"anchor":1032},"The disk: in use, reserved, available","the-disk-in-use-reserved-available",{"title":1034,"anchor":1035},"Disk use by account","disk-use-by-account",{"title":1037,"anchor":1038},"Alerts reach the operator by mail","alerts-reach-the-operator-by-mail",{"title":1040,"anchor":1041},"Panel log level","panel-log-level",[1043,1046,1049,1052,1055,1058],{"title":1044,"anchor":1045},"The passphrase file","the-passphrase-file",{"title":1047,"anchor":1048},"Take a backup","take-a-backup",{"title":1050,"anchor":1051},"What the archive contains","what-the-archive-contains",{"title":1053,"anchor":1054},"Restore onto a clean server","restore-onto-a-clean-server",{"title":1056,"anchor":1057},"Schedule it, keep a few, send a copy off the server","schedule-it-keep-a-few-send-a-copy-off-the-server",{"title":1059,"anchor":1060},"Limitations","limitations",[1062,1065,1068,1071,1074,1077],{"title":1063,"anchor":1064},"Order one","order-one",{"title":1066,"anchor":1067},"The host name comes from the server","the-host-name-comes-from-the-server",{"title":1069,"anchor":1070},"The port 80 challenge block","the-port-80-challenge-block",{"title":1072,"anchor":1073},"Renewal","renewal",{"title":1075,"anchor":1076},"When issuance fails","when-issuance-fails",{"title":1078,"anchor":1079},"Limits to know","limits-to-know",[1081,1084,1087,1090,1093,1096,1099,1100,1103,1106],{"title":1082,"anchor":1083},"The sidebar and the breadcrumb","the-sidebar-and-the-breadcrumb",{"title":1085,"anchor":1086},"Light, dark or system theme","light-dark-or-system-theme",{"title":1088,"anchor":1089},"Favourites","favourites",{"title":1091,"anchor":1092},"The server selector","the-server-selector",{"title":1094,"anchor":1095},"Switching between accounts","switching-between-accounts",{"title":1097,"anchor":1098},"The attention badge","the-attention-badge",{"title":605,"anchor":604},{"title":1101,"anchor":1102},"Lists: search, filters and pages","lists-search-filters-and-pages",{"title":1104,"anchor":1105},"Tables on a phone","tables-on-a-phone",{"title":1107,"anchor":1108},"Background tasks and their progress","background-tasks-and-their-progress",[1110,1113,1116,1119,1122,1125,1128,1131],{"title":1111,"anchor":1112},"Run it as root","run-it-as-root",{"title":1114,"anchor":1115},"Reset an administrator's password","reset-an-administrators-password",{"title":1117,"anchor":1118},"When correct two-factor codes are refused","when-correct-two-factor-codes-are-refused",{"title":1120,"anchor":1121},"Change your own password","change-your-own-password",{"title":1123,"anchor":1124},"Check server health","check-server-health",{"title":1126,"anchor":1127},"Free-space floor","free-space-floor",{"title":1129,"anchor":1130},"Collect a support bundle","collect-a-support-bundle",{"title":1132,"anchor":1133},"Read the logs, and change how much is written","read-the-logs-and-change-how-much-is-written",[1135,1138,1139,1142],{"title":1136,"anchor":1137},"Where the private key goes","where-the-private-key-goes",{"title":1072,"anchor":1073},{"title":1140,"anchor":1141},"What this client has not done","what-this-client-has-not-done",{"title":1078,"anchor":1079},[1144,1147,1150,1153],{"title":1145,"anchor":1146},"The panel will not start","the-panel-will-not-start",{"title":1148,"anchor":1149},"A site answers 502 or 404","a-site-answers-502-or-404",{"title":1151,"anchor":1152},"A certificate is not issued","a-certificate-is-not-issued",{"title":1154,"anchor":1155},"The agent is unreachable","the-agent-is-unreachable",[1157,1160,1163,1166,1169],{"title":1158,"anchor":1159},"1. Take a panel backup first","_1-take-a-panel-backup-first",{"title":1161,"anchor":1162},"2. Run the installer again","_2-run-the-installer-again",{"title":1164,"anchor":1165},"What the installer keeps and what it changes","what-the-installer-keeps-and-what-it-changes",{"title":1167,"anchor":1168},"3. Check the result","_3-check-the-result",{"title":1170,"anchor":1171},"If the upgrade fails","if-the-upgrade-fails",[1173,1176,1179,1182,1185,1188],{"title":1174,"anchor":1175},"Configuration is validated by the server itself","configuration-is-validated-by-the-server-itself",{"title":1177,"anchor":1178},"Values are validated, not escaped","values-are-validated-not-escaped",{"title":1180,"anchor":1181},"Aliases","aliases",{"title":1183,"anchor":1184},"Closed sets are chosen, not typed","closed-sets-are-chosen-not-typed",{"title":1186,"anchor":1187},"Several PHP versions at once","several-php-versions-at-once",{"title":1189,"anchor":1190},"Logs","logs",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1192},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 5v16m8.001-2A2 2 0 0 0 22 17V5a2 2 0 0 0-1.999-2L16 3.002A5 5 0 0 0 12 5a5 5 0 0 0-4-2H4a2 2 0 0 0-2 2v12a2 2 0 0 0 1.999 2H8a5 5 0 0 1 4 2a5 5 0 0 1 4-2z\"/>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1194},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M12 15V3m9 12v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4\"/>\u003Cpath d=\"m7 10l5 5l5-5\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1196},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"/>\u003Cpath d=\"m16.24 7.76l-1.804 5.411a2 2 0 0 1-1.265 1.265L7.76 16.24l1.804-5.411a2 2 0 0 1 1.265-1.265z\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1198},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"/>\u003Cpath d=\"m16 12l-4-4l-4 4m4 4V8\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1200},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M12.83 2.18a2 2 0 0 0-1.66 0L2.6 6.08a1 1 0 0 0 0 1.83l8.58 3.91a2 2 0 0 0 1.66 0l8.58-3.9a1 1 0 0 0 0-1.83z\"/>\u003Cpath d=\"M2 12a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 12\"/>\u003Cpath d=\"M2 17a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 17\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1202},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2M16 3.128a4 4 0 0 1 0 7.744M22 21v-2a4 4 0 0 0-3-3.87\"/>\u003Ccircle cx=\"9\" cy=\"7\" r=\"4\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1204},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 22v-5m3-9V2m2 6a1 1 0 0 1 1 1v4a4 4 0 0 1-4 4h-4a4 4 0 0 1-4-4V9a1 1 0 0 1 1-1zM9 8V2\"/>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1206},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"/>\u003Cpath d=\"M12 8v4m0 4h.01\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1208},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"18\" height=\"11\" x=\"3\" y=\"11\" rx=\"2\" ry=\"2\"/>\u003Cpath d=\"M7 11V7a5 5 0 0 1 10 0v4\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1210},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cellipse cx=\"12\" cy=\"5\" rx=\"9\" ry=\"3\"/>\u003Cpath d=\"M3 5v14a9 3 0 0 0 18 0V5\"/>\u003Cpath d=\"M3 12a9 3 0 0 0 18 0\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1212},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M9 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v.5\"/>\u003Cpath d=\"M12 10v4h4\"/>\u003Cpath d=\"m12 14l1.535-1.605a5 5 0 0 1 8 1.5M22 22v-4h-4\"/>\u003Cpath d=\"m22 18l-1.535 1.605a5 5 0 0 1-8-1.5\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1214},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"/>\u003Cpath d=\"m4.93 4.93l4.24 4.24m5.66 0l4.24-4.24m-4.24 9.9l4.24 4.24m-9.9-4.24l-4.24 4.24\"/>\u003Ccircle cx=\"12\" cy=\"12\" r=\"4\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1216},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z\"/>\u003Cpath d=\"m9 12l2 2l4-4\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1218},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"20\" height=\"5\" x=\"2\" y=\"3\" rx=\"1\"/>\u003Cpath d=\"M4 8v11a2 2 0 0 0 2 2h2M20 8v11a2 2 0 0 1-2 2h-2m-7-6l3-3l3 3m-3-3v9\"/>\u003C/g>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1220},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M22 12h-2.48a2 2 0 0 0-1.93 1.46l-2.35 8.36a.25.25 0 0 1-.48 0L9.24 2.18a.25.25 0 0 0-.48 0l-2.35 8.36A2 2 0 0 1 4.49 12H2\"/>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1222},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.106-3.105c.32-.322.863-.22.983.218a6 6 0 0 1-8.259 7.057l-7.91 7.91a1 1 0 0 1-2.999-3l7.91-7.91a6 6 0 0 1 7.057-8.259c.438.12.54.662.219.984z\"/>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":1224},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71\"/>\u003Cpath d=\"M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71\"/>\u003C/g>",1793873007490]