[{"data":1,"prerenderedAt":679},["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/websites":469,"i-lucide:link":677},[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":41,"body":472,"description":668,"extension":669,"icon":44,"meta":670,"navigation":110,"order":43,"path":671,"rawbody":672,"section":28,"seo":673,"seoTitle":674,"stem":675,"__hash__":676},"docsEn/en/docs/websites.md",{"type":473,"value":474,"toc":659},"minimark",[475,479,482,490,493,513,516,518,521,553,556,558,565,580,582,597,599,606,613,643,654,656],[476,477,478],"p",{},"A site is static, PHP, or a reverse proxy. It can carry domain aliases, and its document root lives\ninside its account's home, never outside it.",[480,481,420],"h2",{"id":421},[476,483,484,485,489],{},"The danger in a control panel is that a bad form value turns into a broken\nconfiguration file, which takes down ",[486,487,488],"strong",{},"every other site on the machine","\nat the next reload.",[476,491,492],{},"So a write always follows these steps:",[494,495,496,500,507,510],"ol",{},[497,498,499],"li",{},"render the configuration to a temporary file,",[497,501,502,506],{},[503,504,505],"code",{},"fsync"," and rename it atomically into place,",[497,508,509],{},"ask the server's own validator to check the result,",[497,511,512],{},"reload, and if either the validation or the reload refuses, put the previous file back.",[476,514,515],{},"The validator is the one the server itself ships. It is not a parser this project wrote, which might\naccept what the server would reject.",[480,517,423],{"id":424},[476,519,520],{},"A domain is checked to be a domain: letters, digits, hyphens and dots. Nothing is escaped, because\nthere is no newline in the result that could end one directive and start another of the caller's choosing. The\nsame rule holds everywhere a value reaches a configuration file.",[476,522,523,524,527,528,531,532,531,535,531,538,531,541,544,545,548,549,552],{},"Names that are not a public host name are refused as well, for sites, aliases and certificates: an IP\naddress (any name whose last label is a number), ",[503,525,526],{},"localhost"," and its subdomains, the special-use\nsuffixes ",[503,529,530],{},".local",", ",[503,533,534],{},".localdomain",[503,536,537],{},".internal",[503,539,540],{},".lan",[503,542,543],{},".home.arpa"," and ",[503,546,547],{},".invalid",", and the panel's\nown host name, also with ",[503,550,551],{},"www.",". FTPS applies the fixed set but does not check the panel's own name.\nThe refusal says only that the name cannot be used and never repeats it. A site that already exists\nunder such a name is not removed; it can still be disabled and deleted.",[476,554,555],{},"One consequence to know: a reverse-proxy upstream is checked for shape rather than for destination,\nso a site can be pointed at a service on the same machine's loopback.",[480,557,426],{"id":427},[476,559,560,561,564],{},"A site answers on its own domain and on up to ",[486,562,563],{},"99 aliases",", the additional host names the same vhost\nserves. The limit is not a plan setting. One certificate can name at most 100 hosts and the site's\nown domain is one of them, so 99 aliases is the most a single certificate for the site can cover.",[476,566,567,568,571,572,575,576,579],{},"The create-site form counts the list as you type (\"3 of 99 additional hostnames.\"), says \"A site can\nhave at most 99 additional hostnames.\" as soon as it is too long, and does not create the site until\nit fits. The server enforces the same bound whatever the form shows: a request with more aliases is\nrefused with 400 ",[503,569,570],{},"SiteAliasLimitExceeded",", \"A site cannot have more additional hostnames than one\ncertificate can cover.\", and the server agent refuses it too for every operation that writes the\nsite's configuration. Disabling or deleting a site still works whatever it carries. A program can\nread the bound from ",[503,573,574],{},"GET /api/v1/sites/limits",", which answers ",[503,577,578],{},"{\"maximumAliases\": 99}",".",[480,581,429],{"id":430},[476,583,584,585,588,589,592,593,596],{},"Where a value must come from a fixed set, the interface offers a list instead of a text box, and the\nlist comes from the server. The backend picker on the create-site form and the backend and state\nfilters on the sites list are read from ",[503,586,587],{},"GET /api/v1/sites/choices",", which answers each option as a\n",[503,590,591],{},"value"," and a ",[503,594,595],{},"label"," already written in the language of the interface. The PHP version picker lists\nonly the versions installed on the server. The list is advice: the server checks every submitted value\nagainst the same set, and a value outside it is refused whatever the form allowed.",[480,598,432],{"id":433},[476,600,601,602,605],{},"Each account gets ",[486,603,604],{},"its own php-fpm pool per version",", running as that account's Linux user, with\nthe worker budget its plan allows. Two customers on the same server can run different PHP versions,\nand neither can read the other's files, because the pools run as different users.",[476,607,608,609,612],{},"An administrator adds a version from ",[486,610,611],{},"Sites and domains → PHP versions"," by choosing it from a list. It cannot be typed in. The list holds the versions the server's package repository can install, newest first; versions the\nserver already has are left out. The panel validates the chosen version against the same list again on\nthe server, so a version outside it is refused with a clear message and never reaches the package manager.",[476,614,615,616,619,620,623,624,627,628,631,632,635,636,531,639,642],{},"Each pool listens on a unix socket in ",[503,617,618],{},"/run/maran-php",", a directory of its own that the installer\ncreates and recreates at every boot. It is world-traversable (",[503,621,622],{},"root:root",", mode ",[503,625,626],{},"0755",") so the web\nserver can reach the sockets. Each socket file stays ",[503,629,630],{},"0660"," and belongs to the web server's user, so\nan account cannot connect to another's pool. The agent's own ",[503,633,634],{},"/run/maran"," stays private\n(",[503,637,638],{},"root:maran",[503,640,641],{},"0750",") and holds no PHP sockets. On a server installed before this change, the panel rewrites each PHP site's pool and then its vhost\nwhen it starts after the upgrade. No manual step is needed.",[476,644,645,646,649,650,653],{},"Customers may change a whitelisted subset of settings. A name outside that list is ",[486,647,648],{},"refused, not\nquietly dropped",", so nobody believes a setting applied when it did not. The hardening\nlines above their settings are written as ",[503,651,652],{},"php_admin_value",", which a customer's own setting cannot\ncountermand.",[480,655,435],{"id":436},[476,657,658],{},"Access and error logs stream into the interface live. The stream names a site and a log kind, never\na path. It has limits: each account can have only so many open at once, and a heartbeat keeps a\nquiet log from looking like a dead connection.",{"title":660,"searchDepth":15,"depth":15,"links":661},"",[662,663,664,665,666,667],{"id":421,"depth":15,"text":420},{"id":424,"depth":15,"text":423},{"id":427,"depth":15,"text":426},{"id":430,"depth":15,"text":429},{"id":433,"depth":15,"text":432},{"id":436,"depth":15,"text":435},"How a site's configuration is written and validated before it is served, how several PHP versions run side by side, and what a customer may and may not change.","md",{},"/en/docs/websites","---\ntitle: Websites and PHP\ndescription: How a site's configuration is written and validated before it is served, how several PHP versions run side by side, and what a customer may and may not change.\nseoTitle: Websites and PHP versions on a Maran server\nsection: How it works\norder: 5\nicon: lucide:globe\n---\n\nA site is static, PHP, or a reverse proxy. It can carry domain aliases, and its document root lives\ninside its account's home, never outside it.\n\n## Configuration is validated by the server itself\n\nThe danger in a control panel is that a bad form value turns into a broken\nconfiguration file, which takes down **every other site on the machine**\nat the next reload.\n\nSo a write always follows these steps:\n\n1. render the configuration to a temporary file,\n2. `fsync` and rename it atomically into place,\n3. ask the server's own validator to check the result,\n4. reload, and if either the validation or the reload refuses, put the previous file back.\n\nThe validator is the one the server itself ships. It is not a parser this project wrote, which might\naccept what the server would reject.\n\n## Values are validated, not escaped\n\nA domain is checked to be a domain: letters, digits, hyphens and dots. Nothing is escaped, because\nthere is no newline in the result that could end one directive and start another of the caller's choosing. The\nsame rule holds everywhere a value reaches a configuration file.\n\nNames that are not a public host name are refused as well, for sites, aliases and certificates: an IP\naddress (any name whose last label is a number), `localhost` and its subdomains, the special-use\nsuffixes `.local`, `.localdomain`, `.internal`, `.lan`, `.home.arpa` and `.invalid`, and the panel's\nown host name, also with `www.`. FTPS applies the fixed set but does not check the panel's own name.\nThe refusal says only that the name cannot be used and never repeats it. A site that already exists\nunder such a name is not removed; it can still be disabled and deleted.\n\nOne consequence to know: a reverse-proxy upstream is checked for shape rather than for destination,\nso a site can be pointed at a service on the same machine's loopback.\n\n## Aliases\n\nA site answers on its own domain and on up to **99 aliases**, the additional host names the same vhost\nserves. The limit is not a plan setting. One certificate can name at most 100 hosts and the site's\nown domain is one of them, so 99 aliases is the most a single certificate for the site can cover.\n\nThe create-site form counts the list as you type (\"3 of 99 additional hostnames.\"), says \"A site can\nhave at most 99 additional hostnames.\" as soon as it is too long, and does not create the site until\nit fits. The server enforces the same bound whatever the form shows: a request with more aliases is\nrefused with 400 `SiteAliasLimitExceeded`, \"A site cannot have more additional hostnames than one\ncertificate can cover.\", and the server agent refuses it too for every operation that writes the\nsite's configuration. Disabling or deleting a site still works whatever it carries. A program can\nread the bound from `GET /api/v1/sites/limits`, which answers `{\"maximumAliases\": 99}`.\n\n## Closed sets are chosen, not typed\n\nWhere a value must come from a fixed set, the interface offers a list instead of a text box, and the\nlist comes from the server. The backend picker on the create-site form and the backend and state\nfilters on the sites list are read from `GET /api/v1/sites/choices`, which answers each option as a\n`value` and a `label` already written in the language of the interface. The PHP version picker lists\nonly the versions installed on the server. The list is advice: the server checks every submitted value\nagainst the same set, and a value outside it is refused whatever the form allowed.\n\n## Several PHP versions at once\n\nEach account gets **its own php-fpm pool per version**, running as that account's Linux user, with\nthe worker budget its plan allows. Two customers on the same server can run different PHP versions,\nand neither can read the other's files, because the pools run as different users.\n\nAn administrator adds a version from **Sites and domains → PHP versions** by choosing it from a list. It cannot be typed in. The list holds the versions the server's package repository can install, newest first; versions the\nserver already has are left out. The panel validates the chosen version against the same list again on\nthe server, so a version outside it is refused with a clear message and never reaches the package manager.\n\nEach pool listens on a unix socket in `/run/maran-php`, a directory of its own that the installer\ncreates and recreates at every boot. It is world-traversable (`root:root`, mode `0755`) so the web\nserver can reach the sockets. Each socket file stays `0660` and belongs to the web server's user, so\nan account cannot connect to another's pool. The agent's own `/run/maran` stays private\n(`root:maran`, `0750`) and holds no PHP sockets. On a server installed before this change, the panel rewrites each PHP site's pool and then its vhost\nwhen it starts after the upgrade. No manual step is needed.\n\nCustomers may change a whitelisted subset of settings. A name outside that list is **refused, not\nquietly dropped**, so nobody believes a setting applied when it did not. The hardening\nlines above their settings are written as `php_admin_value`, which a customer's own setting cannot\ncountermand.\n\n## Logs\n\nAccess and error logs stream into the interface live. The stream names a site and a log kind, never\na path. It has limits: each account can have only so many open at once, and a heartbeat keeps a\nquiet log from looking like a dead connection.\n",{"title":41,"description":668},"Websites and PHP versions on a Maran server","en/docs/websites","nshrvSfOIt_0qKV7na55116-7E9KinEFHXk6vrL9Nls",{"left":96,"top":96,"width":97,"height":97,"rotate":96,"vFlip":98,"hFlip":98,"body":678},"\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>",1793873017378]