[{"data":1,"prerenderedAt":1031},["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/recovery":469,"i-lucide:copy":1027,"i-lucide:link":1029},[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":71,"body":472,"description":1018,"extension":1019,"icon":74,"meta":1020,"navigation":110,"order":73,"path":1021,"rawbody":1022,"section":28,"seo":1023,"seoTitle":1024,"stem":1025,"__hash__":1026},"docsEn/en/docs/recovery.md",{"type":473,"value":474,"toc":1004},"minimark",[475,484,534,537,548,571,574,576,593,596,629,636,647,650,655,675,678,680,683,686,735,738,740,766,790,799,801,813,816,818,825,843,850,853,867,874,877,881,884,886,900,918,923,952,961,964,970,972,991,1000],[476,477,478,479,483],"p",{},"The ",[480,481,482],"code",{},"maran"," command is for the moment the panel's own sign-in cannot be used. It is installed with\nthe panel, adds no service, port or network call, and works only from a shell on the server itself.",[485,486,487,500],"table",{},[488,489,490],"thead",{},[491,492,493,497],"tr",{},[494,495,496],"th",{},"Command",[494,498,499],{},"Use it when",[501,502,503,514,524],"tbody",{},[491,504,505,511],{},[506,507,508],"td",{},[480,509,510],{},"maran admin-reset-password",[506,512,513],{},"An administrator lost their password or their authenticator, and the panel cannot mail a reset.",[491,515,516,521],{},[506,517,518],{},[480,519,520],{},"maran status",[506,522,523],{},"You need to know which services are running and what the panel reports about itself, even with the panel down.",[491,525,526,531],{},[506,527,528],{},[480,529,530],{},"maran collect-diagnostics",[506,532,533],{},"You need to send a support bundle to someone who is helping you.",[535,536,357],"h2",{"id":358},[476,538,539,540,543,544,547],{},"The command works only as root, because it can issue a credential for an administrator. Run it with\nits full path so it works whatever ",[480,541,542],{},"PATH"," your ",[480,545,546],{},"sudo"," keeps:",[549,550,555],"pre",{"className":551,"code":552,"language":553,"meta":554,"style":554},"language-bash shiki shiki-themes github-light-high-contrast github-dark-high-contrast","sudo /usr/local/sbin/maran status\n","bash","",[480,556,557],{"__ignoreMap":554},[558,559,561,564,568],"span",{"class":560,"line":10},"line",[558,562,546],{"class":563},"soyes",[558,565,567],{"class":566},"sT6z2"," /usr/local/sbin/maran",[558,569,570],{"class":566}," status\n",[476,572,573],{},"A user who is not root gets a one-line refusal and nothing else.",[535,575,360],{"id":361},[549,577,579],{"className":551,"code":578,"language":553,"meta":554,"style":554},"sudo /usr/local/sbin/maran admin-reset-password admin@example.com\n",[480,580,581],{"__ignoreMap":554},[558,582,583,585,587,590],{"class":560,"line":10},[558,584,546],{"class":563},[558,586,567],{"class":566},[558,588,589],{"class":566}," admin-reset-password",[558,591,592],{"class":566}," admin@example.com\n",[476,594,595],{},"Give the administrator's email address or username. The command then:",[597,598,599,603,606,609],"ol",{},[600,601,602],"li",{},"Accepts only an administrator whose login is active. A customer, a suspended administrator or an\ninvited login that was never accepted is refused with a clear message. Customers reset their\npassword by email in the customer area.",[600,604,605],{},"Cancels any reset link issued earlier, so at most one link is ever live.",[600,607,608],{},"Lifts a lockout from failed sign-ins and signs the account out of every session.",[600,610,611,612,616,617,620,621,624,625,628],{},"Prints a reset link ",[613,614,615],"strong",{},"once, on your terminal",". It is valid for ",[613,618,619],{},"one hour"," and works ",[613,622,623],{},"once",". It is\nnever written to a log or to the audit record, and the command refuses to print it into a pipe or a\nfile unless you add ",[480,626,627],{},"--allow-non-terminal",".",[476,630,631,632,635],{},"Open the link in a browser and choose a new password. If the panel has no public address configured,\nthe command prints a path beginning with ",[480,633,634],{},"/"," and says so; put your panel's address in front of it.",[476,637,638,639,642,643,646],{},"Every use is recorded in the panel's audit log and in the server's authentication log\n(",[480,640,641],{},"authpriv","), naming the account and whether two-factor was cleared. The operator name comes from\n",[480,644,645],{},"SUDO_USER"," and is a claim, not proof.",[476,648,649],{},"If no administrator exists at all, the command says so and points you to the first-run setup page\ninstead of creating one.",[651,652,654],"h3",{"id":653},"when-the-authenticator-is-lost-too","When the authenticator is lost too",[549,656,658],{"className":551,"code":657,"language":553,"meta":554,"style":554},"sudo /usr/local/sbin/maran admin-reset-password admin@example.com --clear-two-factor\n",[480,659,660],{"__ignoreMap":554},[558,661,662,664,666,668,671],{"class":560,"line":10},[558,663,546],{"class":563},[558,665,567],{"class":566},[558,667,589],{"class":566},[558,669,670],{"class":566}," admin@example.com",[558,672,674],{"class":673},"s-5SL"," --clear-two-factor\n",[476,676,677],{},"This also removes the administrator's two-factor enrolment, so the next sign-in needs only the new\npassword. Use it only when the authenticator really is lost, because it lowers that account's\nprotection until the administrator enrols again. Sign in and turn two-factor back on straight away.\nWithout the flag, two-factor is never touched.",[535,679,363],{"id":364},[476,681,682],{},"Authenticator codes are computed from the time, so a server whose clock has drifted refuses every\ncorrect code. The panel watches the clock: when its latest check found the clock not synchronised\nwith a time source, a refused code says so (\"The server's clock is not synchronised…\") instead of\nonly \"That code is not valid\". The dashboard lists \"Server clock not synchronised\" under Needs\nattention, the Monitoring page shows a Clock card with the reason, and the operator is mailed when the\nclock has stayed unsynchronised for ten checks and again when it recovers.",[476,684,685],{},"The panel never sets the time itself. Turn on a time synchronisation service and let it reach a time\nserver:",[549,687,689],{"className":551,"code":688,"language":553,"meta":554,"style":554},"sudo timedatectl set-ntp true             # Debian and Ubuntu: systemd-timesyncd\nsudo systemctl enable --now chronyd       # AlmaLinux and Rocky Linux: chrony\ntimedatectl                               # look for \"System clock synchronized: yes\"\n",[480,690,691,708,727],{"__ignoreMap":554},[558,692,693,695,698,701,704],{"class":560,"line":10},[558,694,546],{"class":563},[558,696,697],{"class":566}," timedatectl",[558,699,700],{"class":566}," set-ntp",[558,702,703],{"class":673}," true",[558,705,707],{"class":706},"sLBg1","             # Debian and Ubuntu: systemd-timesyncd\n",[558,709,710,712,715,718,721,724],{"class":560,"line":15},[558,711,546],{"class":563},[558,713,714],{"class":566}," systemctl",[558,716,717],{"class":566}," enable",[558,719,720],{"class":673}," --now",[558,722,723],{"class":566}," chronyd",[558,725,726],{"class":706},"       # AlmaLinux and Rocky Linux: chrony\n",[558,728,729,732],{"class":560,"line":33},[558,730,731],{"class":563},"timedatectl",[558,733,734],{"class":706},"                               # look for \"System clock synchronized: yes\"\n",[476,736,737],{},"The panel reads the kernel's own verdict. The kernel stops calling the clock synchronised once its\nestimate of the possible error passes sixteen seconds, so a clock that is off by a few seconds but\nstill counts as synchronised is not reported.",[535,739,366],{"id":367},[476,741,742,743,746,747,750,751,754,755,758,759,762,763,628],{},"Anyone signed in to the panel, administrator or customer, can change their own password without the\ne-mail reset link. Open the menu under your name, choose ",[613,744,745],{},"Profile and security",", and use the\n",[613,748,749],{},"Password"," card: ",[613,752,753],{},"Current password",", ",[613,756,757],{},"New password"," and ",[613,760,761],{},"Confirm password",", then\n",[613,764,765],{},"Change password",[767,768,769,780,787],"ul",{},[600,770,771,772,779],{},"The new password must be at least as long as the minimum the security policy sets for resets and\ninvitations; a shorter one is refused. The message currently always names 12 characters, whatever\nthe policy's minimum is (",[773,774,778],"a",{"href":775,"rel":776},"https://github.com/innovayse/maran/issues/300",[777],"nofollow","issue #300",").",[600,781,782,783,786],{},"A wrong current password is refused with 400 ",[480,784,785],{},"CurrentPasswordIncorrect",", \"The current password is\nnot correct.\" It counts towards the account lockout exactly as a failed sign-in does, and while the\naccount is locked every attempt gets the same answer.",[600,788,789],{},"On success the panel says \"Your password has been changed. Every other device has been signed\nout.\" The device you changed it on stays signed in; every other session ends.",[476,791,792,793,796,797,628],{},"The endpoint is ",[480,794,795],{},"POST /api/v1/auth/change-password",", and it shares the sign-in rate limit. Every\nchange and every refusal is written to the audit log as \"Password changed\", never with either\npassword. The other error codes are listed under ",[773,798,51],{"href":52},[535,800,369],{"id":370},[549,802,803],{"className":551,"code":552,"language":553,"meta":554,"style":554},[480,804,805],{"__ignoreMap":554},[558,806,807,809,811],{"class":560,"line":10},[558,808,546],{"class":563},[558,810,567],{"class":566},[558,812,570],{"class":566},[476,814,815],{},"The first section shows whether the panel, the agent, PostgreSQL and the web server are active and\nenabled (file transfer is included once an administrator has turned it on). The second is the panel's\nown report: database reachability, the agent connection, pending migrations, the version, how many\nadministrators exist and whether the first-run setup window is still open. If the second section\nfails, the first is still shown. The exit status is 0 when everything is healthy and 1 otherwise. The\noutput contains no secrets.",[535,817,372],{"id":373},[476,819,820,821,824],{},"The agent keeps a free-space floor: the space, in MiB, that must still be available on a filesystem\nbefore it starts work that writes there. It is 1 GiB unless you change it in\n",[480,822,823],{},"/etc/maran/agent.env",":",[549,826,828],{"className":551,"code":827,"language":553,"meta":554,"style":554},"MARAN_AGENT_FREE_SPACE_FLOOR_MIB=1024\n",[480,829,830],{"__ignoreMap":554},[558,831,832,836,840],{"class":560,"line":10},[558,833,835],{"class":834},"suds8","MARAN_AGENT_FREE_SPACE_FLOOR_MIB",[558,837,839],{"class":838},"sHUrx","=",[558,841,842],{"class":566},"1024\n",[476,844,845,846,849],{},"The installer writes 1024 and keeps your value when it is re-run. The unit passes it to the agent\nas ",[480,847,848],{},"--free-space-floor-mib","; without the flag the agent applies the same 1024. It must be a whole\nnumber from 1. Zero or any other value makes the agent refuse to start, since an unreadable floor\nshould not be treated as zero. Only root can change it; nothing the panel sends carries a floor.",[476,851,852],{},"While less than the floor is available on the filesystem the operation would write into, these are\nrefused before anything is written:",[767,854,855,858,861,864],{},[600,856,857],{},"creating an account,",[600,859,860],{},"taking a backup,",[600,862,863],{},"restoring a backup,",[600,865,866],{},"accepting an upload.",[476,868,869,870,873],{},"The refusal is the error ",[480,871,872],{},"AgentBelowFreeSpaceFloor"," (HTTP 503), shown in your language as \"The\nserver is nearly out of disk space…\", in the response and as the failure of a backup or restore\ntask. A filesystem that cannot be measured is refused too. Suspending, deleting and every read keep\nworking, so you can free space from the panel.",[476,875,876],{},"The floor is checked before the work starts and the space is not reserved. Another writer can still\nfill the disk afterwards, and the write paths keep their own all-or-nothing handling for that case.",[651,878,880],{"id":879},"the-approaching-floor-alert","The approaching floor alert",[476,882,883],{},"The panel mails the operator when the root filesystem has had less than twice the floor available\nfor ten consecutive checks, so the warning arrives before the refusals begin. A second mail says\nwhen free space is clear of the floor again. If the account homes live on a separate filesystem, the\nrefusal still follows that filesystem, but there is no earlier alert, because the alert watches the\nroot filesystem only.",[535,885,375],{"id":376},[549,887,889],{"className":551,"code":888,"language":553,"meta":554,"style":554},"sudo /usr/local/sbin/maran collect-diagnostics\n",[480,890,891],{"__ignoreMap":554},[558,892,893,895,897],{"class":560,"line":10},[558,894,546],{"class":563},[558,896,567],{"class":566},[558,898,899],{"class":566}," collect-diagnostics\n",[476,901,902,903,906,907,910,911,914,915,628],{},"This writes ",[480,904,905],{},"maran-diagnostics-\u003Ctime>-\u003Cid>.tar.gz"," into ",[480,908,909],{},"/root",", readable by root only. Choose another\ndirectory with ",[480,912,913],{},"--out DIR"," (an absolute path, owned by root and not writable by others), or leave the\nlogs out with ",[480,916,917],{},"--no-logs",[476,919,920],{},[613,921,922],{},"What it contains:",[767,924,925,931,934,937,940,943,946],{},[600,926,927,928,930],{},"the service report from ",[480,929,520],{},", which includes the database and migration facts;",[600,932,933],{},"the operating system release, the panel's systemd units and the state of its services;",[600,935,936],{},"the two Maran web server configuration files;",[600,938,939],{},"the NAMES of the panel's settings, never their values;",[600,941,942],{},"the panel certificate's subject, issuer and validity dates;",[600,944,945],{},"the firewall ruleset;",[600,947,948,949,951],{},"unless ",[480,950,917],{},", the last seven days of the panel, agent and web server journal (capped in size) and the\nend of the panel's own top-level log files.",[476,953,954,957,958,628],{},[613,955,956],{},"What it never reads:"," customers' files and home directories, the sites' own logs, backups, database\ndumps, private keys, and the values in ",[480,959,960],{},"panel.env",[476,962,963],{},"Known secrets and common secret shapes are removed from every text, then the finished archive is\nunpacked and scanned again. If that scan finds anything, the archive is deleted and the command fails\ninstead of leaving you a bundle you might send.",[476,965,966,969],{},[613,967,968],{},"Review it before you send it."," Redaction removes what this server is known to hold, and it cannot be\nproven complete. IP addresses, host names and customer domain names are not removed. Extract the\narchive, read it, and send it only to people you trust with that information.",[535,971,378],{"id":379},[476,973,974,975,978,979,982,983,986,987,990],{},"The panel and the server agent write to the systemd journal: read them with ",[480,976,977],{},"journalctl -u maran-api","\nand ",[480,980,981],{},"journalctl -u maran-agent",". journald bounds their size. Files under ",[480,984,985],{},"/var/log/maran"," are rotated\nby policies the installer puts in ",[480,988,989],{},"/etc/logrotate.d/",": the install log monthly (twelve kept), the\npanel's own web server logs daily (thirty kept), the sites' web server logs daily (fourteen kept) and\nthe FTPS log weekly (four kept). Re-run the installer on an older server to get the install log's\npolicy.",[476,992,993,996,997,999],{},[613,994,995],{},"Change the panel's log level without a restart."," Monitoring → ",[613,998,286],{}," shows the level\nthe panel is logging at and lets an administrator choose Verbose, Debug, Information (the normal\nlevel), Warning, Error or Fatal. The change applies to the next line written, is kept across restarts,\nand is recorded in the audit log with the level before and after. Raise it while you investigate a\nproblem, then set it back. No level makes the panel write a password, a key or a token. The server\nagent's own level cannot be changed this way yet.",[1001,1002,1003],"style",{},"html pre.shiki code .soyes, html code.shiki .soyes{--shiki-default:#702C00;--shiki-dark:#FFB757}html pre.shiki code .sT6z2, html code.shiki .sT6z2{--shiki-default:#032563;--shiki-dark:#ADDCFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s-5SL, html code.shiki .s-5SL{--shiki-default:#023B95;--shiki-dark:#91CBFF}html pre.shiki code .sLBg1, html code.shiki .sLBg1{--shiki-default:#66707B;--shiki-dark:#BDC4CC}html pre.shiki code .suds8, html code.shiki .suds8{--shiki-default:#0E1116;--shiki-dark:#F0F3F6}html pre.shiki code .sHUrx, html code.shiki .sHUrx{--shiki-default:#A0111F;--shiki-dark:#FF9492}",{"title":554,"searchDepth":15,"depth":15,"links":1005},[1006,1007,1010,1011,1012,1013,1016,1017],{"id":358,"depth":15,"text":357},{"id":361,"depth":15,"text":360,"children":1008},[1009],{"id":653,"depth":33,"text":654},{"id":364,"depth":15,"text":363},{"id":367,"depth":15,"text":366},{"id":370,"depth":15,"text":369},{"id":373,"depth":15,"text":372,"children":1014},[1015],{"id":879,"depth":33,"text":880},{"id":376,"depth":15,"text":375},{"id":379,"depth":15,"text":378},"Regain access to the panel when the administrator password or authenticator is lost, check server health, and collect a redacted support bundle.","md",{},"/en/docs/recovery","---\ntitle: Recovery and diagnostics\ndescription: Regain access to the panel when the administrator password or authenticator is lost, check server health, and collect a redacted support bundle.\nseoTitle: 'Recover admin access and collect diagnostics'\nsection: How it works\norder: 10\nicon: lucide:life-buoy\n---\n\nThe `maran` command is for the moment the panel's own sign-in cannot be used. It is installed with\nthe panel, adds no service, port or network call, and works only from a shell on the server itself.\n\n| Command | Use it when |\n|---|---|\n| `maran admin-reset-password` | An administrator lost their password or their authenticator, and the panel cannot mail a reset. |\n| `maran status` | You need to know which services are running and what the panel reports about itself, even with the panel down. |\n| `maran collect-diagnostics` | You need to send a support bundle to someone who is helping you. |\n\n## Run it as root\n\nThe command works only as root, because it can issue a credential for an administrator. Run it with\nits full path so it works whatever `PATH` your `sudo` keeps:\n\n```bash\nsudo /usr/local/sbin/maran status\n```\n\nA user who is not root gets a one-line refusal and nothing else.\n\n## Reset an administrator's password\n\n```bash\nsudo /usr/local/sbin/maran admin-reset-password admin@example.com\n```\n\nGive the administrator's email address or username. The command then:\n\n1. Accepts only an administrator whose login is active. A customer, a suspended administrator or an\n   invited login that was never accepted is refused with a clear message. Customers reset their\n   password by email in the customer area.\n2. Cancels any reset link issued earlier, so at most one link is ever live.\n3. Lifts a lockout from failed sign-ins and signs the account out of every session.\n4. Prints a reset link **once, on your terminal**. It is valid for **one hour** and works **once**. It is\n   never written to a log or to the audit record, and the command refuses to print it into a pipe or a\n   file unless you add `--allow-non-terminal`.\n\nOpen the link in a browser and choose a new password. If the panel has no public address configured,\nthe command prints a path beginning with `/` and says so; put your panel's address in front of it.\n\nEvery use is recorded in the panel's audit log and in the server's authentication log\n(`authpriv`), naming the account and whether two-factor was cleared. The operator name comes from\n`SUDO_USER` and is a claim, not proof.\n\nIf no administrator exists at all, the command says so and points you to the first-run setup page\ninstead of creating one.\n\n### When the authenticator is lost too\n\n```bash\nsudo /usr/local/sbin/maran admin-reset-password admin@example.com --clear-two-factor\n```\n\nThis also removes the administrator's two-factor enrolment, so the next sign-in needs only the new\npassword. Use it only when the authenticator really is lost, because it lowers that account's\nprotection until the administrator enrols again. Sign in and turn two-factor back on straight away.\nWithout the flag, two-factor is never touched.\n\n## When correct two-factor codes are refused\n\nAuthenticator codes are computed from the time, so a server whose clock has drifted refuses every\ncorrect code. The panel watches the clock: when its latest check found the clock not synchronised\nwith a time source, a refused code says so (\"The server's clock is not synchronised…\") instead of\nonly \"That code is not valid\". The dashboard lists \"Server clock not synchronised\" under Needs\nattention, the Monitoring page shows a Clock card with the reason, and the operator is mailed when the\nclock has stayed unsynchronised for ten checks and again when it recovers.\n\nThe panel never sets the time itself. Turn on a time synchronisation service and let it reach a time\nserver:\n\n```bash\nsudo timedatectl set-ntp true             # Debian and Ubuntu: systemd-timesyncd\nsudo systemctl enable --now chronyd       # AlmaLinux and Rocky Linux: chrony\ntimedatectl                               # look for \"System clock synchronized: yes\"\n```\n\nThe panel reads the kernel's own verdict. The kernel stops calling the clock synchronised once its\nestimate of the possible error passes sixteen seconds, so a clock that is off by a few seconds but\nstill counts as synchronised is not reported.\n\n## Change your own password\n\nAnyone signed in to the panel, administrator or customer, can change their own password without the\ne-mail reset link. Open the menu under your name, choose **Profile and security**, and use the\n**Password** card: **Current password**, **New password** and **Confirm password**, then\n**Change password**.\n\n- The new password must be at least as long as the minimum the security policy sets for resets and\n  invitations; a shorter one is refused. The message currently always names 12 characters, whatever\n  the policy's minimum is ([issue #300](https://github.com/innovayse/maran/issues/300)).\n- A wrong current password is refused with 400 `CurrentPasswordIncorrect`, \"The current password is\n  not correct.\" It counts towards the account lockout exactly as a failed sign-in does, and while the\n  account is locked every attempt gets the same answer.\n- On success the panel says \"Your password has been changed. Every other device has been signed\n  out.\" The device you changed it on stays signed in; every other session ends.\n\nThe endpoint is `POST /api/v1/auth/change-password`, and it shares the sign-in rate limit. Every\nchange and every refusal is written to the audit log as \"Password changed\", never with either\npassword. The other error codes are listed under [API error codes](/docs/api-errors).\n\n## Check server health\n\n```bash\nsudo /usr/local/sbin/maran status\n```\n\nThe first section shows whether the panel, the agent, PostgreSQL and the web server are active and\nenabled (file transfer is included once an administrator has turned it on). The second is the panel's\nown report: database reachability, the agent connection, pending migrations, the version, how many\nadministrators exist and whether the first-run setup window is still open. If the second section\nfails, the first is still shown. The exit status is 0 when everything is healthy and 1 otherwise. The\noutput contains no secrets.\n\n## Free-space floor\n\nThe agent keeps a free-space floor: the space, in MiB, that must still be available on a filesystem\nbefore it starts work that writes there. It is 1 GiB unless you change it in\n`/etc/maran/agent.env`:\n\n```bash\nMARAN_AGENT_FREE_SPACE_FLOOR_MIB=1024\n```\n\nThe installer writes 1024 and keeps your value when it is re-run. The unit passes it to the agent\nas `--free-space-floor-mib`; without the flag the agent applies the same 1024. It must be a whole\nnumber from 1. Zero or any other value makes the agent refuse to start, since an unreadable floor\nshould not be treated as zero. Only root can change it; nothing the panel sends carries a floor.\n\nWhile less than the floor is available on the filesystem the operation would write into, these are\nrefused before anything is written:\n\n- creating an account,\n- taking a backup,\n- restoring a backup,\n- accepting an upload.\n\nThe refusal is the error `AgentBelowFreeSpaceFloor` (HTTP 503), shown in your language as \"The\nserver is nearly out of disk space…\", in the response and as the failure of a backup or restore\ntask. A filesystem that cannot be measured is refused too. Suspending, deleting and every read keep\nworking, so you can free space from the panel.\n\nThe floor is checked before the work starts and the space is not reserved. Another writer can still\nfill the disk afterwards, and the write paths keep their own all-or-nothing handling for that case.\n\n### The approaching floor alert\n\nThe panel mails the operator when the root filesystem has had less than twice the floor available\nfor ten consecutive checks, so the warning arrives before the refusals begin. A second mail says\nwhen free space is clear of the floor again. If the account homes live on a separate filesystem, the\nrefusal still follows that filesystem, but there is no earlier alert, because the alert watches the\nroot filesystem only.\n\n## Collect a support bundle\n\n```bash\nsudo /usr/local/sbin/maran collect-diagnostics\n```\n\nThis writes `maran-diagnostics-\u003Ctime>-\u003Cid>.tar.gz` into `/root`, readable by root only. Choose another\ndirectory with `--out DIR` (an absolute path, owned by root and not writable by others), or leave the\nlogs out with `--no-logs`.\n\n**What it contains:**\n\n- the service report from `maran status`, which includes the database and migration facts;\n- the operating system release, the panel's systemd units and the state of its services;\n- the two Maran web server configuration files;\n- the NAMES of the panel's settings, never their values;\n- the panel certificate's subject, issuer and validity dates;\n- the firewall ruleset;\n- unless `--no-logs`, the last seven days of the panel, agent and web server journal (capped in size) and the\n  end of the panel's own top-level log files.\n\n**What it never reads:** customers' files and home directories, the sites' own logs, backups, database\ndumps, private keys, and the values in `panel.env`.\n\nKnown secrets and common secret shapes are removed from every text, then the finished archive is\nunpacked and scanned again. If that scan finds anything, the archive is deleted and the command fails\ninstead of leaving you a bundle you might send.\n\n**Review it before you send it.** Redaction removes what this server is known to hold, and it cannot be\nproven complete. IP addresses, host names and customer domain names are not removed. Extract the\narchive, read it, and send it only to people you trust with that information.\n\n## Read the logs, and change how much is written\n\nThe panel and the server agent write to the systemd journal: read them with `journalctl -u maran-api`\nand `journalctl -u maran-agent`. journald bounds their size. Files under `/var/log/maran` are rotated\nby policies the installer puts in `/etc/logrotate.d/`: the install log monthly (twelve kept), the\npanel's own web server logs daily (thirty kept), the sites' web server logs daily (fourteen kept) and\nthe FTPS log weekly (four kept). Re-run the installer on an older server to get the install log's\npolicy.\n\n**Change the panel's log level without a restart.** Monitoring → **Panel log level** shows the level\nthe panel is logging at and lets an administrator choose Verbose, Debug, Information (the normal\nlevel), Warning, Error or Fatal. The change applies to the next line written, is kept across restarts,\nand is recorded in the audit log with the level before and after. Raise it while you investigate a\nproblem, then set it back. No level makes the panel write a password, a key or a token. The server\nagent's own level cannot be changed this way yet.\n",{"title":71,"description":1018},"Recover admin access and collect diagnostics","en/docs/recovery","WlICqOe4q225zzCLLQY56R51QGwoWBfL3VsogJAAmu0",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":1028},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\" ry=\"2\"/>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"/>\u003C/g>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":1030},"\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>",1793873016875]