[{"data":1,"prerenderedAt":1233},["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/troubleshooting":469,"i-lucide:link":1229,"i-lucide:copy":1231},[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":91,"body":472,"description":1220,"extension":1221,"icon":94,"meta":1222,"navigation":110,"order":93,"path":1223,"rawbody":1224,"section":28,"seo":1225,"seoTitle":1226,"stem":1227,"__hash__":1228},"docsEn/en/docs/troubleshooting.md",{"type":473,"value":474,"toc":1214},"minimark",[475,505,529,552,555,576,581,634,669,674,729,731,743,747,828,879,883,904,906,938,942,1024,1028,1054,1056,1072,1076,1127,1158,1162,1210],[476,477,478,479,483,484,487,488,491,492,496,497,500,501,504],"p",{},"Each playbook below has the same three parts: the ",[480,481,482],"strong",{},"symptoms"," you see, the ",[480,485,486],{},"checks"," that tell the\ncauses apart, and the ",[480,489,490],{},"fixes",". Run every command on the server itself, as root. Two tools help in\nall four cases: ",[493,494,495],"code",{},"maran status"," shows which services are running even when the panel is down, and\n",[493,498,499],{},"maran collect-diagnostics"," writes a redacted archive for whoever is helping you (both are described\nunder ",[502,503,71],"a",{"href":72},").",[506,507,512],"pre",{"className":508,"code":509,"language":510,"meta":511,"style":511},"language-bash shiki shiki-themes github-light-high-contrast github-dark-high-contrast","sudo /usr/local/sbin/maran status\n","bash","",[493,513,514],{"__ignoreMap":511},[515,516,518,522,526],"span",{"class":517,"line":10},"line",[515,519,521],{"class":520},"soyes","sudo",[515,523,525],{"class":524},"sT6z2"," /usr/local/sbin/maran",[515,527,528],{"class":524}," status\n",[476,530,531,532,535,536,539,540,543,544,547,548,551],{},"The services are ",[493,533,534],{},"maran-api"," (the panel), ",[493,537,538],{},"maran-agent"," (the root daemon that does the privileged\nwork), ",[493,541,542],{},"postgresql"," and ",[493,545,546],{},"nginx","; ",[493,549,550],{},"maran-ftps"," is listed too once file transfer is turned on. Their\nlogs are in the systemd journal.",[553,554,391],"h2",{"id":392},[476,556,557,560,561,563,564,567,568,571,572,575],{},[480,558,559],{},"Symptoms."," The browser cannot open the panel on port 8443, or opens it and every call answers 502.\n",[493,562,495],{}," shows ",[493,565,566],{},"maran-api.service"," as ",[493,569,570],{},"failed"," or ",[493,573,574],{},"activating",", or the Panel section says its own\nreport is unavailable.",[476,577,578],{},[480,579,580],{},"Checks.",[506,582,584],{"className":508,"code":583,"language":510,"meta":511,"style":511},"sudo systemctl status maran-api.service --no-pager\nsudo journalctl -u maran-api.service -n 50 --no-pager\nls -l /run/maran-api/api.sock\n",[493,585,586,603,623],{"__ignoreMap":511},[515,587,588,590,593,596,599],{"class":517,"line":10},[515,589,521],{"class":520},[515,591,592],{"class":524}," systemctl",[515,594,595],{"class":524}," status",[515,597,598],{"class":524}," maran-api.service",[515,600,602],{"class":601},"s-5SL"," --no-pager\n",[515,604,605,607,610,613,615,618,621],{"class":517,"line":15},[515,606,521],{"class":520},[515,608,609],{"class":524}," journalctl",[515,611,612],{"class":601}," -u",[515,614,598],{"class":524},[515,616,617],{"class":601}," -n",[515,619,620],{"class":601}," 50",[515,622,602],{"class":601},[515,624,625,628,631],{"class":517,"line":33},[515,626,627],{"class":520},"ls",[515,629,630],{"class":601}," -l",[515,632,633],{"class":524}," /run/maran-api/api.sock\n",[635,636,637,649,659,666],"ul",{},[638,639,640,641,644,645,648],"li",{},"The journal names the reason when the panel refuses to start: an encryption or signing key in\n",[493,642,643],{},"/etc/maran/panel.env"," that is missing, is the published development key or is malformed, or a\nmissing ",[493,646,647],{},"ReverseProxy__PeerUid"," (the web server's user ID, which the installer writes).",[638,650,651,652,655,656,658],{},"The panel connects to PostgreSQL over its local socket, so check ",[493,653,654],{},"postgresql.service"," in\n",[493,657,495],{}," as well.",[638,660,661,662,665],{},"A healthy panel socket exists at ",[493,663,664],{},"/run/maran-api/api.sock"," with mode 660. Absent means the panel\nnever bound it; a different mode or group means nginx cannot open it and every call answers 502.",[638,667,668],{},"The unit gives up after five starts within sixty seconds. If the journal shows that, look earlier\nin the journal for the cause; the last line will not name it.",[476,670,671],{},[480,672,673],{},"Fixes.",[675,676,677,683,690,721],"ol",{},[638,678,679,680,682],{},"Fix what the journal names, for example the offending line in ",[493,681,643],{},". Never\nreplace the encryption key by hand unless the panel's refusal message tells you to: it makes\nstored secrets unreadable.",[638,684,685,686,689],{},"Start PostgreSQL first if it was down: ",[493,687,688],{},"sudo systemctl start postgresql.service",".",[638,691,692,693],{},"Clear the start limit and start the panel:",[506,694,696],{"className":508,"code":695,"language":510,"meta":511,"style":511},"sudo systemctl reset-failed maran-api.service\nsudo systemctl restart maran-api.service\n",[493,697,698,710],{"__ignoreMap":511},[515,699,700,702,704,707],{"class":517,"line":10},[515,701,521],{"class":520},[515,703,592],{"class":524},[515,705,706],{"class":524}," reset-failed",[515,708,709],{"class":524}," maran-api.service\n",[515,711,712,714,716,719],{"class":517,"line":15},[515,713,521],{"class":520},[515,715,592],{"class":524},[515,717,718],{"class":524}," restart",[515,720,709],{"class":524},[638,722,723,724,726,727,689],{},"If the files themselves are damaged, re-run the installer: it is safe to repeat (see\n",[502,725,13],{"href":14},"). To get back into the panel when only the sign-in is the\nproblem, see ",[502,728,71],{"href":72},[553,730,394],{"id":395},[476,732,733,735,736,571,739,742],{},[480,734,559],{}," A hosted site returns ",[493,737,738],{},"502 Bad Gateway",[493,740,741],{},"404 Not Found",", while the panel itself\nworks.",[476,744,745],{},[480,746,580],{},[506,748,750],{"className":508,"code":749,"language":510,"meta":511,"style":511},"sudo nginx -t\nsudo systemctl status nginx.service --no-pager\nls /etc/maran/nginx/sites/\nls -l /run/maran-php/\nsudo tail -n 50 /var/log/maran/sites/\u003Caccount>/*.log\n",[493,751,752,762,775,782,791],{"__ignoreMap":511},[515,753,754,756,759],{"class":517,"line":10},[515,755,521],{"class":520},[515,757,758],{"class":524}," nginx",[515,760,761],{"class":601}," -t\n",[515,763,764,766,768,770,773],{"class":517,"line":15},[515,765,521],{"class":520},[515,767,592],{"class":524},[515,769,595],{"class":524},[515,771,772],{"class":524}," nginx.service",[515,774,602],{"class":601},[515,776,777,779],{"class":517,"line":33},[515,778,627],{"class":520},[515,780,781],{"class":524}," /etc/maran/nginx/sites/\n",[515,783,784,786,788],{"class":517,"line":38},[515,785,627],{"class":520},[515,787,630],{"class":601},[515,789,790],{"class":524}," /run/maran-php/\n",[515,792,793,795,798,800,802,805,809,812,816,819,822,825],{"class":517,"line":43},[515,794,521],{"class":520},[515,796,797],{"class":524}," tail",[515,799,617],{"class":601},[515,801,620],{"class":601},[515,803,804],{"class":524}," /var/log/maran/sites/",[515,806,808],{"class":807},"sHUrx","\u003C",[515,810,811],{"class":524},"accoun",[515,813,815],{"class":814},"suds8","t",[515,817,818],{"class":807},">",[515,820,821],{"class":524},"/",[515,823,824],{"class":601},"*",[515,826,827],{"class":524},".log\n",[635,829,830,844,858,866],{},[638,831,832,835,836,839,840,843],{},[493,833,834],{},"nginx -t"," must pass. Every site has its own configuration file in ",[493,837,838],{},"/etc/maran/nginx/sites/",",\nincluded through ",[493,841,842],{},"/etc/nginx/conf.d/maran-sites.conf",". A site with no file there is a site nginx\ndoes not know, so its name answers with another site or the default.",[638,845,846,847,850,851,854,855,857],{},"A ",[480,848,849],{},"502"," on a PHP site means nginx could not reach the site's PHP pool: its socket is in\n",[493,852,853],{},"/run/maran-php",". A ",[480,856,849],{}," on a reverse-proxy site means the upstream service you pointed it at is\nnot running or not listening.",[638,859,846,860,863,864,689],{},[480,861,862],{},"404"," means nginx answered but found nothing: the domain is not one of the site's domain names\nor aliases, the site is suspended or disabled, the DNS name points to a different server, or the\ndocument root has no index file. See ",[502,865,41],{"href":42},[638,867,868,869,872,873,543,876,689],{},"The site's own access and error logs are in ",[493,870,871],{},"/var/log/maran/sites/\u003Caccount>/",", outside the\ncustomer's home; the panel also streams them in the site's page. The panel's web server logs are\n",[493,874,875],{},"/var/log/maran/nginx-access.log",[493,877,878],{},"/var/log/maran/nginx-error.log",[476,880,881],{},[480,882,673],{},[675,884,885,888,891,898],{},[638,886,887],{},"Correct the domain, aliases or document root in the panel, or enable the site again, and\ncheck the DNS record.",[638,889,890],{},"For a reverse-proxy site, start the upstream service.",[638,892,893,894,897],{},"For a missing PHP socket or a site written by an earlier release, restart the panel:\n",[493,895,896],{},"sudo systemctl restart maran-api.service",". On start it asks the agent to bring every PHP site's\npool and web server configuration back in line.",[638,899,900,901,903],{},"A configuration write is checked with the web server's own validator and rolled back if it fails,\nso a site cannot normally break the others. If ",[493,902,834],{}," fails on a file that is not Maran's,\nfix that file first: it stops reloads for every site.",[553,905,397],{"id":398},[476,907,908,910,911,914,915,914,918,921,922,914,925,914,928,931,932,935,936,504],{},[480,909,559],{}," Ordering a certificate for a site, or a trusted one for the panel, fails. The error is\none of ",[493,912,913],{},"AcmeValidationFailed",", ",[493,916,917],{},"AcmeValidationTimedOut",[493,919,920],{},"AcmeAuthorityUnreachable",",\n",[493,923,924],{},"AcmeChallengeWriteFailed",[493,926,927],{},"PanelHostNameNotConfigured",[493,929,930],{},"PanelChallengeWriteFailed"," or\n",[493,933,934],{},"AgentBelowFreeSpaceFloor"," (all listed in ",[502,937,51],{"href":52},[476,939,940],{},[480,941,580],{},[635,943,944,984,997,1017],{},[638,945,946,947,950,951,980,983],{},"Certificates use the ACME HTTP-01 challenge, so the authority must reach your server over plain\nHTTP on ",[480,948,949],{},"port 80",". The domain must resolve to this server and nothing may block port 80,\nneither a firewall in front of the machine nor the server's own ruleset:",[506,952,954],{"className":508,"code":953,"language":510,"meta":511,"style":511},"sudo nft list ruleset\ncurl -I http://example.com/.well-known/acme-challenge/test\n",[493,955,956,969],{"__ignoreMap":511},[515,957,958,960,963,966],{"class":517,"line":10},[515,959,521],{"class":520},[515,961,962],{"class":524}," nft",[515,964,965],{"class":524}," list",[515,967,968],{"class":524}," ruleset\n",[515,970,971,974,977],{"class":517,"line":15},[515,972,973],{"class":520},"curl",[515,975,976],{"class":601}," -I",[515,978,979],{"class":524}," http://example.com/.well-known/acme-challenge/test\n",[981,982],"br",{},"A 404 from the second command is fine: it proves port 80 answers for that name.",[638,985,846,986,989,990,921,993,996],{},[480,987,988],{},"site"," challenge is served from the site's own document root, so the site must exist, be\nenabled and answer on the name you ordered. A name the panel reserves (an IP address, ",[493,991,992],{},"localhost",[493,994,995],{},".local"," and similar, or the panel's own host name) is refused before any request is made.",[638,998,999,1000,1003,1004,1007,1008,1010,1011,1014,1015,689],{},"The ",[480,1001,1002],{},"panel's"," certificate needs ",[493,1005,1006],{},"Panel__HostName"," in ",[493,1009,643],{}," to be a real name\nthat points at this server. Its challenge is served from ",[493,1012,1013],{},"/var/lib/maran-acme"," by the port 80 block\nof the panel's web server configuration; a server installed before that block existed needs the\ninstaller re-run. See ",[502,1016,76],{"href":77},[638,1018,1019,1020,1023],{},"Free space: ",[493,1021,1022],{},"df -h",". Below the free-space floor (1 GiB unless changed) writes are refused.",[476,1025,1026],{},[480,1027,673],{},[675,1029,1030,1033,1039,1045],{},[638,1031,1032],{},"Point the DNS record at this server and open port 80, then order again. A failed order replaces\nnothing: the certificate already in use stays in place.",[638,1034,1035,1036,1038],{},"Set ",[493,1037,1006],{}," if it is missing, restart the panel and order again, or re-run the\ninstaller if the port 80 block is missing.",[638,1040,1041,1042,1044],{},"Free disk space if ",[493,1043,934],{}," is the error.",[638,1046,1047,1048,1051,1052,689],{},"Wildcard names and DNS-01 are not supported, so a name like ",[493,1049,1050],{},"*.example.com"," cannot be ordered. How\nordering and renewal work is on ",[502,1053,56],{"href":57},[553,1055,400],{"id":401},[476,1057,1058,1060,1061,1064,1065,1067,1068,1071],{},[480,1059,559],{}," Actions that change the server (creating an account or a site, a certificate order, a\nbackup) fail with an agent error such as ",[493,1062,1063],{},"AgentIncompatible",", while pages that only read panel data\nstill load. The panel's health report shows the agent as unavailable, and ",[493,1066,495],{}," shows\n",[493,1069,1070],{},"maran-agent.service"," as not active.",[476,1073,1074],{},[480,1075,580],{},[506,1077,1079],{"className":508,"code":1078,"language":510,"meta":511,"style":511},"sudo systemctl status maran-agent.service --no-pager\nsudo journalctl -u maran-agent.service -n 50 --no-pager\nls -l /run/maran/agent.sock\ncat /etc/maran/agent.env\n",[493,1080,1081,1094,1110,1119],{"__ignoreMap":511},[515,1082,1083,1085,1087,1089,1092],{"class":517,"line":10},[515,1084,521],{"class":520},[515,1086,592],{"class":524},[515,1088,595],{"class":524},[515,1090,1091],{"class":524}," maran-agent.service",[515,1093,602],{"class":601},[515,1095,1096,1098,1100,1102,1104,1106,1108],{"class":517,"line":15},[515,1097,521],{"class":520},[515,1099,609],{"class":524},[515,1101,612],{"class":601},[515,1103,1091],{"class":524},[515,1105,617],{"class":601},[515,1107,620],{"class":601},[515,1109,602],{"class":601},[515,1111,1112,1114,1116],{"class":517,"line":33},[515,1113,627],{"class":520},[515,1115,630],{"class":601},[515,1117,1118],{"class":524}," /run/maran/agent.sock\n",[515,1120,1121,1124],{"class":517,"line":38},[515,1122,1123],{"class":520},"cat",[515,1125,1126],{"class":524}," /etc/maran/agent.env\n",[635,1128,1129,1142,1150,1155],{},[638,1130,1131,1132,1135,1136,1007,1139,689],{},"The agent listens on a unix socket, ",[493,1133,1134],{},"/run/maran/agent.sock",", which should be mode 660, owned by\nroot, in the panel's group. Nothing else may connect, and the agent accepts only the user ID in\n",[493,1137,1138],{},"MARAN_AGENT_ALLOW_UID",[493,1140,1141],{},"/etc/maran/agent.env",[638,1143,1144,1147,1148,504],{},[493,1145,1146],{},"MARAN_AGENT_FREE_SPACE_FLOOR_MIB"," in the same file must be a whole number from 1: anything else\nmakes the agent refuse to start (see the free-space floor in\n",[502,1149,71],{"href":72},[638,1151,1152,1154],{},[493,1153,1063],{}," means the panel and the agent are at different versions, for instance during\nan update. They must be updated together.",[638,1156,1157],{},"The panel starts without the agent and only logs a warning, so the panel being up says nothing\nabout the agent.",[476,1159,1160],{},[480,1161,673],{},[675,1163,1164,1193,1200,1203],{},[638,1165,1166,1167],{},"Restart the agent, then the panel, in that order:",[506,1168,1170],{"className":508,"code":1169,"language":510,"meta":511,"style":511},"sudo systemctl restart maran-agent.service\nsudo systemctl restart maran-api.service\n",[493,1171,1172,1183],{"__ignoreMap":511},[515,1173,1174,1176,1178,1180],{"class":517,"line":10},[515,1175,521],{"class":520},[515,1177,592],{"class":524},[515,1179,718],{"class":524},[515,1181,1182],{"class":524}," maran-agent.service\n",[515,1184,1185,1187,1189,1191],{"class":517,"line":15},[515,1186,521],{"class":520},[515,1188,592],{"class":524},[515,1190,718],{"class":524},[515,1192,709],{"class":524},[638,1194,1195,1196,1199],{},"If the unit keeps failing, fix what its journal names (for example the floor value) and run\n",[493,1197,1198],{},"sudo systemctl reset-failed maran-agent.service"," before restarting.",[638,1201,1202],{},"If the versions differ, re-run the installer so both come from the same release.",[638,1204,1205,1206,1209],{},"If it still fails, run ",[493,1207,1208],{},"sudo /usr/local/sbin/maran collect-diagnostics",", read the archive, and send\nit to whoever is helping you.",[1211,1212,1213],"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 .sHUrx, html code.shiki .sHUrx{--shiki-default:#A0111F;--shiki-dark:#FF9492}html pre.shiki code .suds8, html code.shiki .suds8{--shiki-default:#0E1116;--shiki-dark:#F0F3F6}",{"title":511,"searchDepth":15,"depth":15,"links":1215},[1216,1217,1218,1219],{"id":392,"depth":15,"text":391},{"id":395,"depth":15,"text":394},{"id":398,"depth":15,"text":397},{"id":401,"depth":15,"text":400},"Playbooks for the four commonest failures: the panel does not start, a site answers 502 or 404, a certificate is not issued, and the agent is unreachable.","md",{},"/en/docs/troubleshooting","---\ntitle: Troubleshooting\ndescription: 'Playbooks for the four commonest failures: the panel does not start, a site answers 502 or 404, a certificate is not issued, and the agent is unreachable.'\nseoTitle: 'Troubleshoot a Maran server: four playbooks'\nsection: How it works\norder: 14\nicon: lucide:wrench\n---\n\nEach playbook below has the same three parts: the **symptoms** you see, the **checks** that tell the\ncauses apart, and the **fixes**. Run every command on the server itself, as root. Two tools help in\nall four cases: `maran status` shows which services are running even when the panel is down, and\n`maran collect-diagnostics` writes a redacted archive for whoever is helping you (both are described\nunder [Recovery and diagnostics](/docs/recovery)).\n\n```bash\nsudo /usr/local/sbin/maran status\n```\n\nThe services are `maran-api` (the panel), `maran-agent` (the root daemon that does the privileged\nwork), `postgresql` and `nginx`; `maran-ftps` is listed too once file transfer is turned on. Their\nlogs are in the systemd journal.\n\n## The panel will not start\n\n**Symptoms.** The browser cannot open the panel on port 8443, or opens it and every call answers 502.\n`maran status` shows `maran-api.service` as `failed` or `activating`, or the Panel section says its own\nreport is unavailable.\n\n**Checks.**\n\n```bash\nsudo systemctl status maran-api.service --no-pager\nsudo journalctl -u maran-api.service -n 50 --no-pager\nls -l /run/maran-api/api.sock\n```\n\n- The journal names the reason when the panel refuses to start: an encryption or signing key in\n  `/etc/maran/panel.env` that is missing, is the published development key or is malformed, or a\n  missing `ReverseProxy__PeerUid` (the web server's user ID, which the installer writes).\n- The panel connects to PostgreSQL over its local socket, so check `postgresql.service` in\n  `maran status` as well.\n- A healthy panel socket exists at `/run/maran-api/api.sock` with mode 660. Absent means the panel\n  never bound it; a different mode or group means nginx cannot open it and every call answers 502.\n- The unit gives up after five starts within sixty seconds. If the journal shows that, look earlier\n  in the journal for the cause; the last line will not name it.\n\n**Fixes.**\n\n1. Fix what the journal names, for example the offending line in `/etc/maran/panel.env`. Never\n   replace the encryption key by hand unless the panel's refusal message tells you to: it makes\n   stored secrets unreadable.\n2. Start PostgreSQL first if it was down: `sudo systemctl start postgresql.service`.\n3. Clear the start limit and start the panel:\n\n   ```bash\n   sudo systemctl reset-failed maran-api.service\n   sudo systemctl restart maran-api.service\n   ```\n\n4. If the files themselves are damaged, re-run the installer: it is safe to repeat (see\n   [Installation](/docs/installation)). To get back into the panel when only the sign-in is the\n   problem, see [Recovery and diagnostics](/docs/recovery).\n\n## A site answers 502 or 404\n\n**Symptoms.** A hosted site returns `502 Bad Gateway` or `404 Not Found`, while the panel itself\nworks.\n\n**Checks.**\n\n```bash\nsudo nginx -t\nsudo systemctl status nginx.service --no-pager\nls /etc/maran/nginx/sites/\nls -l /run/maran-php/\nsudo tail -n 50 /var/log/maran/sites/\u003Caccount>/*.log\n```\n\n- `nginx -t` must pass. Every site has its own configuration file in `/etc/maran/nginx/sites/`,\n  included through `/etc/nginx/conf.d/maran-sites.conf`. A site with no file there is a site nginx\n  does not know, so its name answers with another site or the default.\n- A **502** on a PHP site means nginx could not reach the site's PHP pool: its socket is in\n  `/run/maran-php`. A **502** on a reverse-proxy site means the upstream service you pointed it at is\n  not running or not listening.\n- A **404** means nginx answered but found nothing: the domain is not one of the site's domain names\n  or aliases, the site is suspended or disabled, the DNS name points to a different server, or the\n  document root has no index file. See [Websites and PHP](/docs/websites).\n- The site's own access and error logs are in `/var/log/maran/sites/\u003Caccount>/`, outside the\n  customer's home; the panel also streams them in the site's page. The panel's web server logs are\n  `/var/log/maran/nginx-access.log` and `/var/log/maran/nginx-error.log`.\n\n**Fixes.**\n\n1. Correct the domain, aliases or document root in the panel, or enable the site again, and\n   check the DNS record.\n2. For a reverse-proxy site, start the upstream service.\n3. For a missing PHP socket or a site written by an earlier release, restart the panel:\n   `sudo systemctl restart maran-api.service`. On start it asks the agent to bring every PHP site's\n   pool and web server configuration back in line.\n4. A configuration write is checked with the web server's own validator and rolled back if it fails,\n   so a site cannot normally break the others. If `nginx -t` fails on a file that is not Maran's,\n   fix that file first: it stops reloads for every site.\n\n## A certificate is not issued\n\n**Symptoms.** Ordering a certificate for a site, or a trusted one for the panel, fails. The error is\none of `AcmeValidationFailed`, `AcmeValidationTimedOut`, `AcmeAuthorityUnreachable`,\n`AcmeChallengeWriteFailed`, `PanelHostNameNotConfigured`, `PanelChallengeWriteFailed` or\n`AgentBelowFreeSpaceFloor` (all listed in [API error codes](/docs/api-errors)).\n\n**Checks.**\n\n- Certificates use the ACME HTTP-01 challenge, so the authority must reach your server over plain\n  HTTP on **port 80**. The domain must resolve to this server and nothing may block port 80,\n  neither a firewall in front of the machine nor the server's own ruleset:\n\n  ```bash\n  sudo nft list ruleset\n  curl -I http://example.com/.well-known/acme-challenge/test\n  ```\n\n  A 404 from the second command is fine: it proves port 80 answers for that name.\n- A **site** challenge is served from the site's own document root, so the site must exist, be\n  enabled and answer on the name you ordered. A name the panel reserves (an IP address, `localhost`,\n  `.local` and similar, or the panel's own host name) is refused before any request is made.\n- The **panel's** certificate needs `Panel__HostName` in `/etc/maran/panel.env` to be a real name\n  that points at this server. Its challenge is served from `/var/lib/maran-acme` by the port 80 block\n  of the panel's web server configuration; a server installed before that block existed needs the\n  installer re-run. See [Panel certificate](/docs/panel-certificate).\n- Free space: `df -h`. Below the free-space floor (1 GiB unless changed) writes are refused.\n\n**Fixes.**\n\n1. Point the DNS record at this server and open port 80, then order again. A failed order replaces\n   nothing: the certificate already in use stays in place.\n2. Set `Panel__HostName` if it is missing, restart the panel and order again, or re-run the\n   installer if the port 80 block is missing.\n3. Free disk space if `AgentBelowFreeSpaceFloor` is the error.\n4. Wildcard names and DNS-01 are not supported, so a name like `*.example.com` cannot be ordered. How\n   ordering and renewal work is on [SSL certificates](/docs/ssl).\n\n## The agent is unreachable\n\n**Symptoms.** Actions that change the server (creating an account or a site, a certificate order, a\nbackup) fail with an agent error such as `AgentIncompatible`, while pages that only read panel data\nstill load. The panel's health report shows the agent as unavailable, and `maran status` shows\n`maran-agent.service` as not active.\n\n**Checks.**\n\n```bash\nsudo systemctl status maran-agent.service --no-pager\nsudo journalctl -u maran-agent.service -n 50 --no-pager\nls -l /run/maran/agent.sock\ncat /etc/maran/agent.env\n```\n\n- The agent listens on a unix socket, `/run/maran/agent.sock`, which should be mode 660, owned by\n  root, in the panel's group. Nothing else may connect, and the agent accepts only the user ID in\n  `MARAN_AGENT_ALLOW_UID` in `/etc/maran/agent.env`.\n- `MARAN_AGENT_FREE_SPACE_FLOOR_MIB` in the same file must be a whole number from 1: anything else\n  makes the agent refuse to start (see the free-space floor in\n  [Recovery and diagnostics](/docs/recovery)).\n- `AgentIncompatible` means the panel and the agent are at different versions, for instance during\n  an update. They must be updated together.\n- The panel starts without the agent and only logs a warning, so the panel being up says nothing\n  about the agent.\n\n**Fixes.**\n\n1. Restart the agent, then the panel, in that order:\n\n   ```bash\n   sudo systemctl restart maran-agent.service\n   sudo systemctl restart maran-api.service\n   ```\n\n2. If the unit keeps failing, fix what its journal names (for example the floor value) and run\n   `sudo systemctl reset-failed maran-agent.service` before restarting.\n3. If the versions differ, re-run the installer so both come from the same release.\n4. If it still fails, run `sudo /usr/local/sbin/maran collect-diagnostics`, read the archive, and send\n   it to whoever is helping you.\n",{"title":91,"description":1220},"Troubleshoot a Maran server: four playbooks","en/docs/troubleshooting","EdTE75O2beO2v8QroGQHzpZiuD1JjUywwXTgut3pf3s",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":1230},"\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>",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":1232},"\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>",1793873017061]