[{"data":1,"prerenderedAt":811},["ShallowReactive",2],{"docs-navigation-en":3,"i-lucide:search":95,"i-lucide:sun":100,"i-lucide:globe":102,"i-lucide:menu":104,"i-lucide:chevron-down":106,"i-lucide:github":108,"i-lucide:map-pin":111,"docs-headings-en":113,"i-lucide:book-open":437,"i-lucide:download":439,"i-lucide:compass":441,"i-lucide:arrow-up-circle":443,"i-lucide:layers":445,"i-lucide:users":447,"i-lucide:plug":449,"i-lucide:circle-alert":451,"i-lucide:lock":453,"i-lucide:database":455,"i-lucide:folder-sync":457,"i-lucide:life-buoy":459,"i-lucide:shield-check":461,"i-lucide:archive-restore":463,"i-lucide:activity":465,"i-lucide:wrench":467,"docs-en-/docs/panel-interface":469,"i-lucide:link":809},[4,27],{"section":5,"items":6},"Getting started",[7,12,17,22],{"title":8,"path":9,"order":10,"icon":11},"Introduction","/docs",1,"lucide:book-open",{"title":13,"path":14,"order":15,"icon":16},"Installation","/docs/installation",2,"lucide:download",{"title":18,"path":19,"order":20,"icon":21},"Finding your way around the panel","/docs/panel-interface",2.5,"lucide:compass",{"title":23,"path":24,"order":25,"icon":26},"Upgrading Maran","/docs/upgrade",2.7,"lucide:arrow-up-circle",{"section":28,"items":29},"How it works",[30,35,40,45,50,55,60,65,70,75,80,85,90],{"title":31,"path":32,"order":33,"icon":34},"How it is built","/docs/architecture",3,"lucide:layers",{"title":36,"path":37,"order":38,"icon":39},"Hosting accounts","/docs/accounts",4,"lucide:users",{"title":41,"path":42,"order":43,"icon":44},"Websites and PHP","/docs/websites",5,"lucide:globe",{"title":46,"path":47,"order":48,"icon":49},"The provisioning API","/docs/api",6,"lucide:plug",{"title":51,"path":52,"order":53,"icon":54},"API error codes","/docs/api-errors",6.5,"lucide:circle-alert",{"title":56,"path":57,"order":58,"icon":59},"SSL certificates","/docs/ssl",7,"lucide:lock",{"title":61,"path":62,"order":63,"icon":64},"Databases","/docs/databases",8,"lucide:database",{"title":66,"path":67,"order":68,"icon":69},"File transfer and backups","/docs/file-transfer",9,"lucide:folder-sync",{"title":71,"path":72,"order":73,"icon":74},"Recovery and diagnostics","/docs/recovery",10,"lucide:life-buoy",{"title":76,"path":77,"order":78,"icon":79},"Panel certificate","/docs/panel-certificate",11,"lucide:shield-check",{"title":81,"path":82,"order":83,"icon":84},"Panel backup and restore","/docs/panel-backup",12,"lucide:archive-restore",{"title":86,"path":87,"order":88,"icon":89},"Dashboard and monitoring","/docs/monitoring",13,"lucide:activity",{"title":91,"path":92,"order":93,"icon":94},"Troubleshooting","/docs/troubleshooting",14,"lucide:wrench",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":99},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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":101},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":103},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":105},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M4 5h16M4 12h16M4 19h16\"/>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":107},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m6 9l6 6l6-6\"/>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":109,"hidden":110},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":112},"\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>",{"/docs/accounts":114,"/docs/api":154,"/docs/api-errors":179,"/docs/architecture":192,"/docs/databases":208,"/docs/file-transfer":221,"/docs":240,"/docs/installation":253,"/docs/monitoring":269,"/docs/panel-backup":288,"/docs/panel-certificate":307,"/docs/panel-interface":326,"/docs/recovery":355,"/docs/ssl":380,"/docs/troubleshooting":389,"/docs/upgrade":402,"/docs/websites":418},[115,118,121,124,127,130,133,136,139,142,145,148,151],{"title":116,"anchor":117},"What creating one does","what-creating-one-does",{"title":119,"anchor":120},"The new account form","the-new-account-form",{"title":122,"anchor":123},"Suspension is a state, not a deletion","suspension-is-a-state-not-a-deletion",{"title":125,"anchor":126},"Deleting removes what the account left behind","deleting-removes-what-the-account-left-behind",{"title":128,"anchor":129},"Plans","plans",{"title":131,"anchor":132},"Plan features","plan-features",{"title":134,"anchor":135},"Team access: sub-users","team-access-sub-users",{"title":137,"anchor":138},"More than one account per login","more-than-one-account-per-login",{"title":140,"anchor":141},"Viewing as an account","viewing-as-an-account",{"title":143,"anchor":144},"Runtime limits","runtime-limits",{"title":146,"anchor":147},"Running a scheduled task now","running-a-scheduled-task-now",{"title":149,"anchor":150},"What a customer sees","what-a-customer-sees",{"title":152,"anchor":153},"One limitation worth knowing","one-limitation-worth-knowing",[155,158,161,164,167,170,173,176],{"title":156,"anchor":157},"A login, not a key yet","a-login-not-a-key-yet",{"title":159,"anchor":160},"The account lifecycle","the-account-lifecycle",{"title":162,"anchor":163},"Plan features, accounts and views","plan-features-accounts-and-views",{"title":165,"anchor":166},"Answers without a body","answers-without-a-body",{"title":168,"anchor":169},"Renamed response fields","renamed-response-fields",{"title":171,"anchor":172},"What it is not","what-it-is-not",{"title":174,"anchor":175},"Errors say what a caller may know","errors-say-what-a-caller-may-know",{"title":177,"anchor":178},"Every error code","every-error-code",[180,183,186,189],{"title":181,"anchor":182},"The status comes from the kind of failure","the-status-comes-from-the-kind-of-failure",{"title":184,"anchor":185},"Codes worth knowing first","codes-worth-knowing-first",{"title":187,"anchor":188},"A failed background task carries the same codes","a-failed-background-task-carries-the-same-codes",{"title":190,"anchor":191},"Every code","every-code",[193,196,199,202,205],{"title":194,"anchor":195},"The three processes","the-three-processes",{"title":197,"anchor":198},"The contract between them","the-contract-between-them",{"title":200,"anchor":201},"Writing a configuration file","writing-a-configuration-file",{"title":203,"anchor":204},"Isolation between accounts","isolation-between-accounts",{"title":206,"anchor":207},"What is deliberately absent","what-is-deliberately-absent",[209,212,215,218],{"title":210,"anchor":211},"Isolation is built, not assumed","isolation-is-built-not-assumed",{"title":213,"anchor":214},"The password is shown once","the-password-is-shown-once",{"title":216,"anchor":217},"Dropping is final","dropping-is-final",{"title":219,"anchor":220},"The grant repair, for hosts that ran an older build","the-grant-repair-for-hosts-that-ran-an-older-build",[222,225,228,231,234,237],{"title":223,"anchor":224},"Each login is jailed, and the jail is real","each-login-is-jailed-and-the-jail-is-real",{"title":226,"anchor":227},"Resetting or deleting a login ends its open sessions","resetting-or-deleting-a-login-ends-its-open-sessions",{"title":229,"anchor":230},"Public keys live outside the jail","public-keys-live-outside-the-jail",{"title":232,"anchor":233},"FTPS ships installed and switched off","ftps-ships-installed-and-switched-off",{"title":235,"anchor":236},"Backups","backups",{"title":238,"anchor":239},"What nothing re-checks","what-nothing-re-checks",[241,244,247,250],{"title":242,"anchor":243},"Three processes, and only one of them is root","three-processes-and-only-one-of-them-is-root",{"title":245,"anchor":246},"What a hosting account is","what-a-hosting-account-is",{"title":248,"anchor":249},"No brokers, no sidecars","no-brokers-no-sidecars",{"title":251,"anchor":252},"Keyboard, screen readers and motion","keyboard-screen-readers-and-motion",[254,257,260,263,266],{"title":255,"anchor":256},"Run the installer","run-the-installer",{"title":258,"anchor":259},"Installing without internet access","installing-without-internet-access",{"title":261,"anchor":262},"The first administrator","the-first-administrator",{"title":264,"anchor":265},"After the first sign-in","after-the-first-sign-in",{"title":267,"anchor":268},"Updates","updates",[270,273,276,279,282,285],{"title":271,"anchor":272},"What the dashboard shows","what-the-dashboard-shows",{"title":274,"anchor":275},"A part that could not be read says so","a-part-that-could-not-be-read-says-so",{"title":277,"anchor":278},"The disk: in use, reserved, available","the-disk-in-use-reserved-available",{"title":280,"anchor":281},"Disk use by account","disk-use-by-account",{"title":283,"anchor":284},"Alerts reach the operator by mail","alerts-reach-the-operator-by-mail",{"title":286,"anchor":287},"Panel log level","panel-log-level",[289,292,295,298,301,304],{"title":290,"anchor":291},"The passphrase file","the-passphrase-file",{"title":293,"anchor":294},"Take a backup","take-a-backup",{"title":296,"anchor":297},"What the archive contains","what-the-archive-contains",{"title":299,"anchor":300},"Restore onto a clean server","restore-onto-a-clean-server",{"title":302,"anchor":303},"Schedule it, keep a few, send a copy off the server","schedule-it-keep-a-few-send-a-copy-off-the-server",{"title":305,"anchor":306},"Limitations","limitations",[308,311,314,317,320,323],{"title":309,"anchor":310},"Order one","order-one",{"title":312,"anchor":313},"The host name comes from the server","the-host-name-comes-from-the-server",{"title":315,"anchor":316},"The port 80 challenge block","the-port-80-challenge-block",{"title":318,"anchor":319},"Renewal","renewal",{"title":321,"anchor":322},"When issuance fails","when-issuance-fails",{"title":324,"anchor":325},"Limits to know","limits-to-know",[327,330,333,336,339,342,345,346,349,352],{"title":328,"anchor":329},"The sidebar and the breadcrumb","the-sidebar-and-the-breadcrumb",{"title":331,"anchor":332},"Light, dark or system theme","light-dark-or-system-theme",{"title":334,"anchor":335},"Favourites","favourites",{"title":337,"anchor":338},"The server selector","the-server-selector",{"title":340,"anchor":341},"Switching between accounts","switching-between-accounts",{"title":343,"anchor":344},"The attention badge","the-attention-badge",{"title":140,"anchor":141},{"title":347,"anchor":348},"Lists: search, filters and pages","lists-search-filters-and-pages",{"title":350,"anchor":351},"Tables on a phone","tables-on-a-phone",{"title":353,"anchor":354},"Background tasks and their progress","background-tasks-and-their-progress",[356,359,362,365,368,371,374,377],{"title":357,"anchor":358},"Run it as root","run-it-as-root",{"title":360,"anchor":361},"Reset an administrator's password","reset-an-administrators-password",{"title":363,"anchor":364},"When correct two-factor codes are refused","when-correct-two-factor-codes-are-refused",{"title":366,"anchor":367},"Change your own password","change-your-own-password",{"title":369,"anchor":370},"Check server health","check-server-health",{"title":372,"anchor":373},"Free-space floor","free-space-floor",{"title":375,"anchor":376},"Collect a support bundle","collect-a-support-bundle",{"title":378,"anchor":379},"Read the logs, and change how much is written","read-the-logs-and-change-how-much-is-written",[381,384,385,388],{"title":382,"anchor":383},"Where the private key goes","where-the-private-key-goes",{"title":318,"anchor":319},{"title":386,"anchor":387},"What this client has not done","what-this-client-has-not-done",{"title":324,"anchor":325},[390,393,396,399],{"title":391,"anchor":392},"The panel will not start","the-panel-will-not-start",{"title":394,"anchor":395},"A site answers 502 or 404","a-site-answers-502-or-404",{"title":397,"anchor":398},"A certificate is not issued","a-certificate-is-not-issued",{"title":400,"anchor":401},"The agent is unreachable","the-agent-is-unreachable",[403,406,409,412,415],{"title":404,"anchor":405},"1. Take a panel backup first","_1-take-a-panel-backup-first",{"title":407,"anchor":408},"2. Run the installer again","_2-run-the-installer-again",{"title":410,"anchor":411},"What the installer keeps and what it changes","what-the-installer-keeps-and-what-it-changes",{"title":413,"anchor":414},"3. Check the result","_3-check-the-result",{"title":416,"anchor":417},"If the upgrade fails","if-the-upgrade-fails",[419,422,425,428,431,434],{"title":420,"anchor":421},"Configuration is validated by the server itself","configuration-is-validated-by-the-server-itself",{"title":423,"anchor":424},"Values are validated, not escaped","values-are-validated-not-escaped",{"title":426,"anchor":427},"Aliases","aliases",{"title":429,"anchor":430},"Closed sets are chosen, not typed","closed-sets-are-chosen-not-typed",{"title":432,"anchor":433},"Several PHP versions at once","several-php-versions-at-once",{"title":435,"anchor":436},"Logs","logs",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":438},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":440},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":442},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":444},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":446},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":448},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":450},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":452},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":454},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":456},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":458},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":460},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":462},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":464},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":466},"\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":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":468},"\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\"/>",{"doc":470,"isFallback":98},{"id":471,"title":18,"body":472,"description":800,"extension":801,"icon":21,"meta":802,"navigation":110,"order":20,"path":803,"rawbody":804,"section":5,"seo":805,"seoTitle":806,"stem":807,"__hash__":808},"docsEn/en/docs/panel-interface.md",{"type":473,"value":474,"toc":787},"minimark",[475,479,482,485,584,591,598,613,616,619,654,657,659,665,667,673,676,678,681,683,686,693,695,701,704,706,721,723,730,751,754,757,764,766,773,775,781,784],[476,477,478],"p",{},"The panel is one interface for administrators and customers alike. This page describes what every\nscreen shares, so the pages about each feature can stay about the feature.",[480,481,328],"h2",{"id":329},[476,483,484],{},"The sidebar is grouped by the job you came to do. It has at most twelve items under four groups:",[486,487,488,500,537,575],"ul",{},[489,490,491,495,496,499],"li",{},[492,493,494],"strong",{},"Overview",": ",[492,497,498],{},"System status",", the dashboard every sign-in lands on.",[489,501,502,495,505,508,509,511,512,515,516,519,520,519,523,525,526,529,530,533,534,536],{},[492,503,504],{},"Hosting",[492,506,507],{},"Accounts"," (the account list, the new-account form and ",[492,510,128],{},"), ",[492,513,514],{},"Sites and\ndomains"," (the site list and the PHP versions), ",[492,517,518],{},"DNS",", ",[492,521,522],{},"Mail",[492,524,61],{}," (the database\nlist and grant repair), ",[492,527,528],{},"Files and access"," (SFTP logins, FTPS logins and ",[492,531,532],{},"Scheduled tasks",",\nthe accounts' cron entries) and ",[492,535,235],{}," (the backup list, the schedule and the destinations).",[489,538,539,495,542,545,546,519,549,552,553,556,557,511,560,552,563,566,567,570,571,574],{},[492,540,541],{},"Infrastructure",[492,543,544],{},"Security"," (the firewall's ",[492,547,548],{},"Rules",[492,550,551],{},"Bans"," and ",[492,554,555],{},"Never banned",", and\nthe sign-in ",[492,558,559],{},"Security policy",[492,561,562],{},"Servers",[492,564,565],{},"Monitoring"," (metrics, ",[492,568,569],{},"Background tasks","\nand the ",[492,572,573],{},"Audit journal",").",[489,576,577,495,580,583],{},[492,578,579],{},"System",[492,581,582],{},"Settings"," (the panel certificate and outgoing mail).",[476,585,586,587,590],{},"An item with more than one page is a section that opens and closes; an item with one page is a\nplain link. The section holding the page you are on opens by itself, even when you arrive from a\nbookmark. On a phone the sidebar is a drawer, opened from the menu button or the tab bar's\n",[492,588,589],{},"More",", and each section is an accordion inside it.",[476,592,593,594,597],{},"Pages that are planned but not built yet (DNS, mail, the server fleet and a few settings) are\nalready in the menu, greyed out and marked ",[492,595,596],{},"Coming soon",". A section with nothing built yet still\nopens to show its pages. These pages cannot be opened and do not appear in search. When one ships,\nit becomes a link in the place where it already stood.",[476,599,600,601,605,606,609,610,612],{},"A page's address does not move when the menu groups it elsewhere: the audit journal is still\n",[602,603,604],"code",{},"/settings/audit"," and the security policy ",[602,607,608],{},"/settings/security-policy",", so bookmarks keep working.\n",[492,611,569],{}," shows how many tasks failed beside its name.",[476,614,615],{},"What you see depends on who you are. An administrator sees the whole tree. A customer sees only\nthe pages for their own account. Hiding an item is only a convenience; every page's server endpoint\nchecks your role itself.",[476,617,618],{},"The small line above each page title is the sidebar group the page sits in. The breadcrumb goes one\nlevel further. A submenu page ends on its own name (Hosting / Backups / Schedule), and a site or an\naccount ends on its domain or name. While that name is loading, the crumb shows a placeholder\ninstead of the identifier from the address.",[476,620,621,622,552,625,628,629,632,633,635,636,519,639,519,642,519,644,552,647,649,650,653],{},"A customer's menu has only their own account in it. It has no server pages, and it adds their own\n",[492,623,624],{},"Activity",[492,626,627],{},"My account"," sections under ",[492,630,631],{},"Your account",". The breadcrumb and the line\nabove the title follow the menu of the person reading it, so a customer's ",[492,634,569],{}," sits\nunder Activity while an administrator's sits under Monitoring. On a phone a customer's bottom bar\nis ",[492,637,638],{},"Home",[492,640,641],{},"Sites",[492,643,522],{},[492,645,646],{},"Account",[492,648,589],{},". The full list is in\n",[651,652,507],"a",{"href":37},".",[476,655,656],{},"Press ⌘K (Ctrl+K) or use the search field in the app bar to jump to any page by name.",[480,658,331],{"id":332},[476,660,661,662,664],{},"The theme is one menu in the app bar on a desktop, and in the navigation drawer on a phone. Its\nbutton shows the current mode's icon and is announced as \"Theme: Light\", \"Theme: Dark\" or\n\"Theme: System\". ",[492,663,579],{}," follows your operating system's light or dark setting, and keeps\nfollowing it while the panel is open. The choice is remembered in the browser.",[480,666,334],{"id":335},[476,668,669,670,672],{},"Every signed-in person can pin up to 8 pages. A star at the end of each openable page in the sidebar,\nand in the phone drawer, pins or unpins it. Pages marked as coming soon, and pages that are locked,\nhave no star. The ",[492,671,334],{}," menu in the app bar lists your pins in the order you pinned them.",[476,674,675],{},"Pins are stored on the server for each user, so they follow you to another browser or device. A pinned\npage that is no longer offered to you, because of your role, a module or your plan, is hidden but\nkept, and it reappears if it is offered again. When all 8 are used, the other stars are disabled and\nsay why. Pins cannot be reordered yet.",[480,677,337],{"id":338},[476,679,680],{},"The app bar names the server being managed once the panel manages more than one. Today the panel\nmanages only its own machine, so there is nothing to select and no selector is shown. It will\nappear, with the switch between servers, when fleet management arrives. Customers never see it.",[480,682,340],{"id":341},[476,684,685],{},"One login can own several hosting accounts. A customer who owns two or more sees an account selector\nin the header. Choosing another account reloads the panel on the dashboard, showing that account's\ndata, without signing out. Signing in starts on the oldest account the login owns.",[476,687,688,689,692],{},"Every switch, and every refused attempt, is written to the audit journal as ",[492,690,691],{},"Switched active\naccount",". Switching to an account you do not belong to is refused as not found. A suspended account is\nleft out of the selector and switching to it is refused with its own message. Creating an extra\naccount for an existing login from the interface is not available yet.",[480,694,343],{"id":344},[476,696,697,698,700],{},"An administrator sees a number beside ",[492,699,498],{}," on the dashboard: how many things need\nattention. It counts certificates about to expire, failed backups, bans, failed tasks and a clock that\nis out of sync. Screen readers hear \"N need attention\". The number refreshes every minute.",[476,702,703],{},"If the count cannot be read, or any one of its sources cannot, no badge is shown at all. The panel\nnever shows 0 or a smaller number in its place. There are no badges yet for the mail queue or for\nserver updates, because those pages are not built.",[480,705,140],{"id":141},[476,707,708,709,712,713,716,717,720],{},"When an administrator is viewing the panel as a customer, a banner stays on every page:\n",[492,710,711],{},"You are viewing as"," the account's name and, in brackets, its login. The ",[492,714,715],{},"Back to"," button,\nfollowed by your name, returns you to your own session on the account's page. See ",[651,718,719],{"href":37},"view as"," for what it does and does not allow.",[480,722,347],{"id":348},[476,724,725,726,729],{},"Every list is paged, searched and sorted ",[492,727,728],{},"on the server",". This covers accounts, plans, sites,\ndatabases, file-transfer logins, backups, certificates, the audit journal, background tasks,\nsigned-in devices, firewall bans and the never-banned list. A list stays fast however many rows the\nserver holds, because the browser only receives the page it shows.",[486,731,732,735,738,748],{},[489,733,734],{},"A list shows 25 rows by default; 10, 50 or 100 can be chosen at its foot.",[489,736,737],{},"The search field matches what the list is about: an account's name or primary domain, a site's\ndomain or owner, a task's subject, an audit entry's actor, subject or address.",[489,739,740,743,744,747],{},[492,741,742],{},"Filters"," opens a dialog on a wide screen and a sheet from the bottom on a phone. Each applied\nfilter shows above the table as a chip you can remove on its own; ",[492,745,746],{},"Clear all"," removes them all.",[489,749,750],{},"Search, sort, filters and the page are kept in the address, so a filtered list can be shared,\nreloaded and walked back with the browser's Back button.",[476,752,753],{},"Pickers that choose an account or a plan search the server as you type too, rather than offering\nthe first hundred entries.",[476,755,756],{},"A value that can only be one of a few, such as the transport protocol of a firewall rule, is chosen\nfrom a list the panel provides, in the interface language. You never type it, and the panel still\nchecks the chosen value when the form is sent. The same holds for the status filter of the\nbackground tasks, the outcome filter of the audit journal and the connection security of the mail\nsettings (no encryption, STARTTLS or implicit TLS).",[476,758,759,760,763],{},"The schedule of a scheduled task is also built from lists. You choose how often, the weekday, the\nday of the month, the hour and the minute instead of typing them. The ",[492,761,762],{},"Expression"," mode remains\nfor a schedule the builder cannot express. The hour and number of copies of a backup schedule, and\nthe status, reason and storage-kind filters of the backups, work the same way. All of these names\ncome from the panel, in the interface language, and the panel checks the chosen value again when\nthe form is sent.",[480,765,350],{"id":351},[476,767,768,769,772],{},"Below 640 pixels wide, every table shows each row as a card. The row's name is the card's title,\nits actions sit in the top right corner, and every other column is a line labelled with that\ncolumn's heading. Nothing scrolls sideways. You can still sort with a ",[492,770,771],{},"Sort by"," select of the\nsortable columns, and a button beside it flips the order. From 640 pixels up, tables look as usual.",[480,774,353],{"id":354},[476,776,777,778,780],{},"Long operations, such as installing a certificate or a PHP version, or taking a backup, run as\nbackground tasks. While any are running, a badge in the app bar shows how many, on every screen. It\ndisappears when nothing is running and opens ",[492,779,569],{}," when clicked. The count updates\nlive over one connection and follows a language switch.",[476,782,783],{},"A task's progress looks the same in the list and in its live view. A failed task shows how far it\ngot, without a bar, and explains the failure in a sentence in your language with its code beneath\nit.",[476,785,786],{},"Every create is confirmed by a short message in the same corner of the screen. A success message\ncloses by itself after a few seconds. An error stays until you close it, so you cannot miss a\nfailure.",{"title":788,"searchDepth":15,"depth":15,"links":789},"",[790,791,792,793,794,795,796,797,798,799],{"id":329,"depth":15,"text":328},{"id":332,"depth":15,"text":331},{"id":335,"depth":15,"text":334},{"id":338,"depth":15,"text":337},{"id":341,"depth":15,"text":340},{"id":344,"depth":15,"text":343},{"id":141,"depth":15,"text":140},{"id":348,"depth":15,"text":347},{"id":351,"depth":15,"text":350},{"id":354,"depth":15,"text":353},"How the sidebar, breadcrumb and theme menu work, how lists search and filter on the server, how tables become cards on a phone, and how tasks show progress.","md",{},"/en/docs/panel-interface","---\ntitle: Finding your way around the panel\ndescription: 'How the sidebar, breadcrumb and theme menu work, how lists search and filter on the server, how tables become cards on a phone, and how tasks show progress.'\nseoTitle: 'Using the panel, navigation, lists, themes'\nsection: Getting started\norder: 2.5\nicon: lucide:compass\n---\n\nThe panel is one interface for administrators and customers alike. This page describes what every\nscreen shares, so the pages about each feature can stay about the feature.\n\n## The sidebar and the breadcrumb\n\nThe sidebar is grouped by the job you came to do. It has at most twelve items under four groups:\n\n- **Overview**: **System status**, the dashboard every sign-in lands on.\n- **Hosting**: **Accounts** (the account list, the new-account form and **Plans**), **Sites and\n  domains** (the site list and the PHP versions), **DNS**, **Mail**, **Databases** (the database\n  list and grant repair), **Files and access** (SFTP logins, FTPS logins and **Scheduled tasks**,\n  the accounts' cron entries) and **Backups** (the backup list, the schedule and the destinations).\n- **Infrastructure**: **Security** (the firewall's **Rules**, **Bans** and **Never banned**, and\n  the sign-in **Security policy**), **Servers** and **Monitoring** (metrics, **Background tasks**\n  and the **Audit journal**).\n- **System**: **Settings** (the panel certificate and outgoing mail).\n\nAn item with more than one page is a section that opens and closes; an item with one page is a\nplain link. The section holding the page you are on opens by itself, even when you arrive from a\nbookmark. On a phone the sidebar is a drawer, opened from the menu button or the tab bar's\n**More**, and each section is an accordion inside it.\n\nPages that are planned but not built yet (DNS, mail, the server fleet and a few settings) are\nalready in the menu, greyed out and marked **Coming soon**. A section with nothing built yet still\nopens to show its pages. These pages cannot be opened and do not appear in search. When one ships,\nit becomes a link in the place where it already stood.\n\nA page's address does not move when the menu groups it elsewhere: the audit journal is still\n`/settings/audit` and the security policy `/settings/security-policy`, so bookmarks keep working.\n**Background tasks** shows how many tasks failed beside its name.\n\nWhat you see depends on who you are. An administrator sees the whole tree. A customer sees only\nthe pages for their own account. Hiding an item is only a convenience; every page's server endpoint\nchecks your role itself.\n\nThe small line above each page title is the sidebar group the page sits in. The breadcrumb goes one\nlevel further. A submenu page ends on its own name (Hosting / Backups / Schedule), and a site or an\naccount ends on its domain or name. While that name is loading, the crumb shows a placeholder\ninstead of the identifier from the address.\n\nA customer's menu has only their own account in it. It has no server pages, and it adds their own\n**Activity** and **My account** sections under **Your account**. The breadcrumb and the line\nabove the title follow the menu of the person reading it, so a customer's **Background tasks** sits\nunder Activity while an administrator's sits under Monitoring. On a phone a customer's bottom bar\nis **Home**, **Sites**, **Mail**, **Account** and **More**. The full list is in\n[Accounts](/docs/accounts).\n\nPress ⌘K (Ctrl+K) or use the search field in the app bar to jump to any page by name.\n\n## Light, dark or system theme\n\nThe theme is one menu in the app bar on a desktop, and in the navigation drawer on a phone. Its\nbutton shows the current mode's icon and is announced as \"Theme: Light\", \"Theme: Dark\" or\n\"Theme: System\". **System** follows your operating system's light or dark setting, and keeps\nfollowing it while the panel is open. The choice is remembered in the browser.\n\n## Favourites\n\nEvery signed-in person can pin up to 8 pages. A star at the end of each openable page in the sidebar,\nand in the phone drawer, pins or unpins it. Pages marked as coming soon, and pages that are locked,\nhave no star. The **Favourites** menu in the app bar lists your pins in the order you pinned them.\n\nPins are stored on the server for each user, so they follow you to another browser or device. A pinned\npage that is no longer offered to you, because of your role, a module or your plan, is hidden but\nkept, and it reappears if it is offered again. When all 8 are used, the other stars are disabled and\nsay why. Pins cannot be reordered yet.\n\n## The server selector\n\nThe app bar names the server being managed once the panel manages more than one. Today the panel\nmanages only its own machine, so there is nothing to select and no selector is shown. It will\nappear, with the switch between servers, when fleet management arrives. Customers never see it.\n\n## Switching between accounts\n\nOne login can own several hosting accounts. A customer who owns two or more sees an account selector\nin the header. Choosing another account reloads the panel on the dashboard, showing that account's\ndata, without signing out. Signing in starts on the oldest account the login owns.\n\nEvery switch, and every refused attempt, is written to the audit journal as **Switched active\naccount**. Switching to an account you do not belong to is refused as not found. A suspended account is\nleft out of the selector and switching to it is refused with its own message. Creating an extra\naccount for an existing login from the interface is not available yet.\n\n## The attention badge\n\nAn administrator sees a number beside **System status** on the dashboard: how many things need\nattention. It counts certificates about to expire, failed backups, bans, failed tasks and a clock that\nis out of sync. Screen readers hear \"N need attention\". The number refreshes every minute.\n\nIf the count cannot be read, or any one of its sources cannot, no badge is shown at all. The panel\nnever shows 0 or a smaller number in its place. There are no badges yet for the mail queue or for\nserver updates, because those pages are not built.\n\n## Viewing as an account\n\nWhen an administrator is viewing the panel as a customer, a banner stays on every page:\n**You are viewing as** the account's name and, in brackets, its login. The **Back to** button,\nfollowed by your name, returns you to your own session on the account's page. See [view as](/docs/accounts) for what it does and does not allow.\n\n## Lists: search, filters and pages\n\nEvery list is paged, searched and sorted **on the server**. This covers accounts, plans, sites,\ndatabases, file-transfer logins, backups, certificates, the audit journal, background tasks,\nsigned-in devices, firewall bans and the never-banned list. A list stays fast however many rows the\nserver holds, because the browser only receives the page it shows.\n\n- A list shows 25 rows by default; 10, 50 or 100 can be chosen at its foot.\n- The search field matches what the list is about: an account's name or primary domain, a site's\n  domain or owner, a task's subject, an audit entry's actor, subject or address.\n- **Filters** opens a dialog on a wide screen and a sheet from the bottom on a phone. Each applied\n  filter shows above the table as a chip you can remove on its own; **Clear all** removes them all.\n- Search, sort, filters and the page are kept in the address, so a filtered list can be shared,\n  reloaded and walked back with the browser's Back button.\n\nPickers that choose an account or a plan search the server as you type too, rather than offering\nthe first hundred entries.\n\nA value that can only be one of a few, such as the transport protocol of a firewall rule, is chosen\nfrom a list the panel provides, in the interface language. You never type it, and the panel still\nchecks the chosen value when the form is sent. The same holds for the status filter of the\nbackground tasks, the outcome filter of the audit journal and the connection security of the mail\nsettings (no encryption, STARTTLS or implicit TLS).\n\nThe schedule of a scheduled task is also built from lists. You choose how often, the weekday, the\nday of the month, the hour and the minute instead of typing them. The **Expression** mode remains\nfor a schedule the builder cannot express. The hour and number of copies of a backup schedule, and\nthe status, reason and storage-kind filters of the backups, work the same way. All of these names\ncome from the panel, in the interface language, and the panel checks the chosen value again when\nthe form is sent.\n\n## Tables on a phone\n\nBelow 640 pixels wide, every table shows each row as a card. The row's name is the card's title,\nits actions sit in the top right corner, and every other column is a line labelled with that\ncolumn's heading. Nothing scrolls sideways. You can still sort with a **Sort by** select of the\nsortable columns, and a button beside it flips the order. From 640 pixels up, tables look as usual.\n\n## Background tasks and their progress\n\nLong operations, such as installing a certificate or a PHP version, or taking a backup, run as\nbackground tasks. While any are running, a badge in the app bar shows how many, on every screen. It\ndisappears when nothing is running and opens **Background tasks** when clicked. The count updates\nlive over one connection and follows a language switch.\n\nA task's progress looks the same in the list and in its live view. A failed task shows how far it\ngot, without a bar, and explains the failure in a sentence in your language with its code beneath\nit.\n\nEvery create is confirmed by a short message in the same corner of the screen. A success message\ncloses by itself after a few seconds. An error stays until you close it, so you cannot miss a\nfailure.\n",{"title":18,"description":800},"Using the panel, navigation, lists, themes","en/docs/panel-interface","QNLSgN7PNYwOb_Yl9-3U-ywsjLRT3mKCU_7OcFaXCMo",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":810},"\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>",1793873016780]