[{"data":1,"prerenderedAt":834},["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/upgrade":469,"i-lucide:copy":830,"i-lucide:link":832},[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":23,"body":472,"description":821,"extension":822,"icon":26,"meta":823,"navigation":110,"order":25,"path":824,"rawbody":825,"section":5,"seo":826,"seoTitle":827,"stem":828,"__hash__":829},"docsEn/en/docs/upgrade.md",{"type":473,"value":474,"toc":811},"minimark",[475,488,491,498,529,536,538,541,567,580,614,621,623,715,720,727,731,734,736,739,753,759,761,764,796,807],[476,477,478,479,483,484,487],"p",{},"Upgrading Maran means running the installer again on the server that already has it. There is no\n",[480,481,482],"code",{},"maran update"," command and no ",[480,485,486],{},"maran rollback"," command, and the panel has no one-click update, so the\nsteps below are the whole procedure. Run them as root, from a shell on the server.",[489,490,404],"h2",{"id":405},[476,492,493,494,497],{},"The installer cannot undo an upgrade, so the backup is your way back. Create it\nexactly as described in ",[495,496,81],"a",{"href":82},":",[499,500,505],"pre",{"className":501,"code":502,"language":503,"meta":504,"style":504},"language-bash shiki shiki-themes github-light-high-contrast github-dark-high-contrast","sudo /usr/local/sbin/maran panel-backup --passphrase-file /root/maran-backup.passphrase\n","bash","",[480,506,507],{"__ignoreMap":504},[508,509,511,515,519,522,526],"span",{"class":510,"line":10},"line",[508,512,514],{"class":513},"soyes","sudo",[508,516,518],{"class":517},"sT6z2"," /usr/local/sbin/maran",[508,520,521],{"class":517}," panel-backup",[508,523,525],{"class":524},"s-5SL"," --passphrase-file",[508,527,528],{"class":517}," /root/maran-backup.passphrase\n",[476,530,531,532,535],{},"Copy the archive off the server, and keep the passphrase somewhere else, not on the server and not\nwith the archive. The panel keeps running while the backup is taken. The archive holds the panel's database,\nits two keys, the licence and ",[480,533,534],{},"/etc/maran","; customers' files and databases are in the account\nbackups instead.",[489,537,407],{"id":408},[476,539,540],{},"Run the same command you installed with:",[499,542,544],{"className":501,"code":543,"language":503,"meta":504,"style":504},"curl -sSL https://get.maran.innovayse.com | sudo bash\n",[480,545,546],{"__ignoreMap":504},[508,547,548,551,554,557,561,564],{"class":510,"line":10},[508,549,550],{"class":513},"curl",[508,552,553],{"class":524}," -sSL",[508,555,556],{"class":517}," https://get.maran.innovayse.com",[508,558,560],{"class":559},"sHUrx"," |",[508,562,563],{"class":513}," sudo",[508,565,566],{"class":517}," bash\n",[476,568,569,570,573,574,577,578,497],{},"The installer is safe to repeat. It fetches the current signed release, verifies the manifest's\nsignature and every archive's checksum before it unpacks anything, and checks each checksum again\njust before extracting that archive. To choose the release channel, run the unpacked installer\nwith ",[480,571,572],{},"--channel stable"," or ",[480,575,576],{},"--channel beta",". A server without internet access uses the offline bundle\ndescribed under ",[495,579,13],{"href":14},[499,581,583],{"className":501,"code":582,"language":503,"meta":504,"style":504},"sudo bash install.sh --offline-tarball \u003Cbundle>.tar.gz\n",[480,584,585],{"__ignoreMap":504},[508,586,587,589,592,595,598,601,604,608,611],{"class":510,"line":10},[508,588,514],{"class":513},[508,590,591],{"class":517}," bash",[508,593,594],{"class":517}," install.sh",[508,596,597],{"class":524}," --offline-tarball",[508,599,600],{"class":559}," \u003C",[508,602,603],{"class":517},"bundl",[508,605,607],{"class":606},"suds8","e",[508,609,610],{"class":559},">",[508,612,613],{"class":517},".tar.gz\n",[476,615,616,617,620],{},"On a re-run the preflight accepts the panel's own port as already taken by this install, and\neverything is appended to ",[480,618,619],{},"/var/log/maran/install.log",", so the log holds the history of every run.",[489,622,410],{"id":411},[624,625,626,639],"table",{},[627,628,629],"thead",{},[630,631,632,636],"tr",{},[633,634,635],"th",{},"Item",[633,637,638],{},"On a re-run",[640,641,642,657,669,680,691,699,707],"tbody",{},[630,643,644,654],{},[645,646,647,650,651],"td",{},[480,648,649],{},"Security__EncryptionKey"," in ",[480,652,653],{},"/etc/maran/panel.env",[645,655,656],{},"Kept. It is never rotated, since a new key would make stored secrets unreadable.",[630,658,659,666],{},[645,660,661,650,664],{},[480,662,663],{},"Jwt__SigningKey",[480,665,653],{},[645,667,668],{},"Kept, so people stay signed in across the upgrade.",[630,670,671,677],{},[645,672,673,674],{},"The agent's free-space floor in ",[480,675,676],{},"/etc/maran/agent.env",[645,678,679],{},"Kept when it is a whole number from 1.",[630,681,682,688],{},[645,683,684,685],{},"The rest of ",[480,686,687],{},"panel.env",[645,689,690],{},"Written again by the installer, and host facts such as the SSH ports are detected afresh. Note any value you changed by hand before you upgrade, and check it afterwards.",[630,692,693,696],{},[645,694,695],{},"The one-time setup token",[645,697,698],{},"Replaced with a new one. It only matters before the first administrator exists.",[630,700,701,704],{},[645,702,703],{},"The panel's database",[645,705,706],{},"Kept, and brought forward by the new release's migrations.",[630,708,709,712],{},[645,710,711],{},"The panel and the agent programs",[645,713,714],{},"Replaced with the new release's.",[716,717,719],"h3",{"id":718},"database-migrations","Database migrations",[476,721,722,723,726],{},"The installer applies every module's database migrations in its own step, after the configuration is\nwritten and before any service is started. It runs the panel's own binary in migrate mode as the\n",[480,724,725],{},"maran"," service account, so a migration the panel could not run fails here, while you are\nwatching, and not as an error an hour later. If the step fails, the installer stops and nothing is\nrestarted.",[716,728,730],{"id":729},"the-panel-and-the-agent-move-together","The panel and the agent move together",[476,732,733],{},"The panel and the server agent talk over a versioned contract, and a release can change its revision.\nThe release notes say so under \"Before you upgrade\" when it happens. The installer replaces both in\none run and then restarts the agent first and the panel second, so run the whole installer and do not\nreplace just one of the two. When the panel starts it also converges every PHP site's pool and\nvirtual host with the new release.",[489,735,413],{"id":414},[476,737,738],{},"When the installer finishes it prints that Maran is installed and reachable at the panel's address.\nThen confirm from the server:",[499,740,742],{"className":501,"code":741,"language":503,"meta":504,"style":504},"sudo /usr/local/sbin/maran status\n",[480,743,744],{"__ignoreMap":504},[508,745,746,748,750],{"class":510,"line":10},[508,747,514],{"class":513},[508,749,518],{"class":517},[508,751,752],{"class":517}," status\n",[476,754,755,756,758],{},"You want every service listed as active and enabled, and the panel's report to show the database\nreachable, the agent connected, no pending migrations and the version you expect. The exit status is 0\nwhen everything is healthy and 1 otherwise; see ",[495,757,71],{"href":72}," for what\neach part means. Then sign in to the panel and open the dashboard.",[489,760,416],{"id":417},[476,762,763],{},"The installer does not roll back. It stops at the failing step and tells you which one. Earlier\nsteps have already run, and later ones have not.",[765,766,767,774,777],"ol",{},[768,769,770,771,773],"li",{},"Read the end of ",[480,772,619],{}," and the message the installer printed.",[768,775,776],{},"Fix the cause and run the installer again. Every step checks the current state before it acts, so a\nrepeat resumes where the last run stopped.",[768,778,779,780,783,784,787,788,791,792,795],{},"If the panel does not start, read ",[480,781,782],{},"journalctl -u maran-api"," and ",[480,785,786],{},"journalctl -u maran-agent",", and run\n",[480,789,790],{},"maran status",", which works even with the panel down. ",[480,793,794],{},"maran collect-diagnostics"," writes a redacted\nbundle to send to whoever is helping you.",[476,797,798,799,802,803,806],{},"If the server cannot be repaired, go back through the backup from step 1. Install Maran on a clean\nserver, using the same release as the backup or a newer one. Do not create an administrator in the\nbrowser. Then run ",[480,800,801],{},"maran panel-restore"," there. The restore applies that release's migrations to the old\ndatabase. The steps, and what the restore refuses, are under ",[495,804,805],{"href":82},"Panel backup and\nrestore",". Do not restore an archive from a newer release onto an older install.\nCustomers' files, sites and databases come back from the account backups.",[808,809,810],"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 pre.shiki code .s-5SL, html code.shiki .s-5SL{--shiki-default:#023B95;--shiki-dark:#91CBFF}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 .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":504,"searchDepth":15,"depth":15,"links":812},[813,814,815,819,820],{"id":405,"depth":15,"text":404},{"id":408,"depth":15,"text":407},{"id":411,"depth":15,"text":410,"children":816},[817,818],{"id":718,"depth":33,"text":719},{"id":729,"depth":33,"text":730},{"id":414,"depth":15,"text":413},{"id":417,"depth":15,"text":416},"Upgrade a running server by taking a panel backup and re-running the installer, what it keeps and migrates, how to check the result, and what to do if it fails.","md",{},"/en/docs/upgrade","---\ntitle: Upgrading Maran\ndescription: 'Upgrade a running server by taking a panel backup and re-running the installer, what it keeps and migrates, how to check the result, and what to do if it fails.'\nseoTitle: 'Upgrade Maran safely'\nsection: Getting started\norder: 2.7\nicon: lucide:arrow-up-circle\n---\n\nUpgrading Maran means running the installer again on the server that already has it. There is no\n`maran update` command and no `maran rollback` command, and the panel has no one-click update, so the\nsteps below are the whole procedure. Run them as root, from a shell on the server.\n\n## 1. Take a panel backup first\n\nThe installer cannot undo an upgrade, so the backup is your way back. Create it\nexactly as described in [Panel backup and restore](/docs/panel-backup):\n\n```bash\nsudo /usr/local/sbin/maran panel-backup --passphrase-file /root/maran-backup.passphrase\n```\n\nCopy the archive off the server, and keep the passphrase somewhere else, not on the server and not\nwith the archive. The panel keeps running while the backup is taken. The archive holds the panel's database,\nits two keys, the licence and `/etc/maran`; customers' files and databases are in the account\nbackups instead.\n\n## 2. Run the installer again\n\nRun the same command you installed with:\n\n```bash\ncurl -sSL https://get.maran.innovayse.com | sudo bash\n```\n\nThe installer is safe to repeat. It fetches the current signed release, verifies the manifest's\nsignature and every archive's checksum before it unpacks anything, and checks each checksum again\njust before extracting that archive. To choose the release channel, run the unpacked installer\nwith `--channel stable` or `--channel beta`. A server without internet access uses the offline bundle\ndescribed under [Installation](/docs/installation):\n\n```bash\nsudo bash install.sh --offline-tarball \u003Cbundle>.tar.gz\n```\n\nOn a re-run the preflight accepts the panel's own port as already taken by this install, and\neverything is appended to `/var/log/maran/install.log`, so the log holds the history of every run.\n\n## What the installer keeps and what it changes\n\n| Item | On a re-run |\n|---|---|\n| `Security__EncryptionKey` in `/etc/maran/panel.env` | Kept. It is never rotated, since a new key would make stored secrets unreadable. |\n| `Jwt__SigningKey` in `/etc/maran/panel.env` | Kept, so people stay signed in across the upgrade. |\n| The agent's free-space floor in `/etc/maran/agent.env` | Kept when it is a whole number from 1. |\n| The rest of `panel.env` | Written again by the installer, and host facts such as the SSH ports are detected afresh. Note any value you changed by hand before you upgrade, and check it afterwards. |\n| The one-time setup token | Replaced with a new one. It only matters before the first administrator exists. |\n| The panel's database | Kept, and brought forward by the new release's migrations. |\n| The panel and the agent programs | Replaced with the new release's. |\n\n### Database migrations\n\nThe installer applies every module's database migrations in its own step, after the configuration is\nwritten and before any service is started. It runs the panel's own binary in migrate mode as the\n`maran` service account, so a migration the panel could not run fails here, while you are\nwatching, and not as an error an hour later. If the step fails, the installer stops and nothing is\nrestarted.\n\n### The panel and the agent move together\n\nThe panel and the server agent talk over a versioned contract, and a release can change its revision.\nThe release notes say so under \"Before you upgrade\" when it happens. The installer replaces both in\none run and then restarts the agent first and the panel second, so run the whole installer and do not\nreplace just one of the two. When the panel starts it also converges every PHP site's pool and\nvirtual host with the new release.\n\n## 3. Check the result\n\nWhen the installer finishes it prints that Maran is installed and reachable at the panel's address.\nThen confirm from the server:\n\n```bash\nsudo /usr/local/sbin/maran status\n```\n\nYou want every service listed as active and enabled, and the panel's report to show the database\nreachable, the agent connected, no pending migrations and the version you expect. The exit status is 0\nwhen everything is healthy and 1 otherwise; see [Recovery and diagnostics](/docs/recovery) for what\neach part means. Then sign in to the panel and open the dashboard.\n\n## If the upgrade fails\n\nThe installer does not roll back. It stops at the failing step and tells you which one. Earlier\nsteps have already run, and later ones have not.\n\n1. Read the end of `/var/log/maran/install.log` and the message the installer printed.\n2. Fix the cause and run the installer again. Every step checks the current state before it acts, so a\n   repeat resumes where the last run stopped.\n3. If the panel does not start, read `journalctl -u maran-api` and `journalctl -u maran-agent`, and run\n   `maran status`, which works even with the panel down. `maran collect-diagnostics` writes a redacted\n   bundle to send to whoever is helping you.\n\nIf the server cannot be repaired, go back through the backup from step 1. Install Maran on a clean\nserver, using the same release as the backup or a newer one. Do not create an administrator in the\nbrowser. Then run `maran panel-restore` there. The restore applies that release's migrations to the old\ndatabase. The steps, and what the restore refuses, are under [Panel backup and\nrestore](/docs/panel-backup). Do not restore an archive from a newer release onto an older install.\nCustomers' files, sites and databases come back from the account backups.\n",{"title":23,"description":821},"Upgrade Maran safely","en/docs/upgrade","vtRVsygM_mMZWyGOIpd6IHtz5gSL3pExuGHO0ccDHgY",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":831},"\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":833},"\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>",1793873017288]