[{"data":1,"prerenderedAt":256},["ShallowReactive",2],{"navigation":3,"\u002Fadministration\u002Fmaintenance":194,"\u002Fadministration\u002Fmaintenance-surround":251},[4,18,31,64,81,102,111,132,149],{"title":5,"path":6,"stem":7,"children":8,"page":17},"Getting started","\u002Fgetting-started","1.getting-started",[9,13],{"title":10,"path":11,"stem":12},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":14,"path":15,"stem":16},"Run your first workflow","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart",false,{"title":19,"path":20,"stem":21,"children":22,"page":17},"Core concepts","\u002Fconcepts","2.concepts",[23,27],{"title":24,"path":25,"stem":26},"The platform model","\u002Fconcepts\u002Fplatform","2.concepts\u002F1.platform",{"title":28,"path":29,"stem":30},"Architecture and boundaries","\u002Fconcepts\u002Farchitecture","2.concepts\u002F2.architecture",{"title":32,"path":33,"stem":34,"children":35,"page":17},"Installation","\u002Finstallation","3.installation",[36,40,44,48,52,56,60],{"title":37,"path":38,"stem":39},"Overview and requirements","\u002Finstallation\u002Foverview","3.installation\u002F1.overview",{"title":41,"path":42,"stem":43},"Local evaluation","\u002Finstallation\u002Flocal-evaluation","3.installation\u002F2.local-evaluation",{"title":45,"path":46,"stem":47},"Install the server","\u002Finstallation\u002Fserver","3.installation\u002F3.server",{"title":49,"path":50,"stem":51},"Install a runner","\u002Finstallation\u002Frunner","3.installation\u002F4.runner",{"title":53,"path":54,"stem":55},"Verify the installation","\u002Finstallation\u002Fverification","3.installation\u002F5.verification",{"title":57,"path":58,"stem":59},"Upgrade the platform","\u002Finstallation\u002Fupgrades","3.installation\u002F6.upgrades",{"title":61,"path":62,"stem":63},"Guided installer","\u002Finstallation\u002Finstaller","3.installation\u002F7.installer",{"title":65,"path":66,"stem":67,"children":68,"page":17},"Build workflows","\u002Fworkflows","4.workflows",[69,73,77],{"title":70,"path":71,"stem":72},"Build a Definition","\u002Fworkflows\u002Fdefinitions","4.workflows\u002F0.definitions",{"title":74,"path":75,"stem":76},"Deploy and run workflows","\u002Fworkflows\u002Fruns","4.workflows\u002F1.runs",{"title":78,"path":79,"stem":80},"Inputs, context, and secrets","\u002Fworkflows\u002Finputs-and-secrets","4.workflows\u002F2.inputs-and-secrets",{"title":82,"path":83,"stem":84,"children":85,"page":17},"Run and recover","\u002Foperations","5.operations",[86,90,94,98],{"title":87,"path":88,"stem":89},"Monitor Runs","\u002Foperations\u002Fmonitoring","5.operations\u002F1.monitoring",{"title":91,"path":92,"stem":93},"Approve prepared steps","\u002Foperations\u002Fapprovals","5.operations\u002F2.approvals",{"title":95,"path":96,"stem":97},"Recover or cancel execution","\u002Foperations\u002Frecovery","5.operations\u002F3.recovery",{"title":99,"path":100,"stem":101},"Troubleshooting","\u002Foperations\u002Ftroubleshooting","5.operations\u002F4.troubleshooting",{"title":103,"path":104,"stem":105,"children":106,"page":17},"Action catalog","\u002Fcatalog","6.catalog",[107],{"title":108,"path":109,"stem":110},"Find and use Actions","\u002Fcatalog\u002Foverview","6.catalog\u002F1.overview",{"title":112,"path":113,"stem":114,"children":115,"page":17},"Administration","\u002Fadministration","7.administration",[116,120,124,128],{"title":117,"path":118,"stem":119},"Registries and Environments","\u002Fadministration\u002Fenvironments","7.administration\u002F2.environments",{"title":121,"path":122,"stem":123},"Manage runners","\u002Fadministration\u002Frunners","7.administration\u002F3.runners",{"title":125,"path":126,"stem":127},"Access and approval policies","\u002Fadministration\u002Faccess","7.administration\u002F4.access",{"title":129,"path":130,"stem":131},"Backups and upgrades","\u002Fadministration\u002Fmaintenance","7.administration\u002F5.maintenance",{"title":133,"path":134,"stem":135,"children":136,"page":17},"Develop Actions","\u002Factions","8.actions",[137,141,145],{"title":138,"path":139,"stem":140},"Build your first Action","\u002Factions\u002Fquickstart","8.actions\u002F1.quickstart",{"title":142,"path":143,"stem":144},"Local development","\u002Factions\u002Flocal-development","8.actions\u002F2.local-development",{"title":146,"path":147,"stem":148},"Publish an Action","\u002Factions\u002Fpublishing","8.actions\u002F3.publishing",{"title":150,"path":151,"stem":152,"children":153,"page":17},"Reference","\u002Freference","9.reference",[154,158,162,166,170,174,178,182,186,190],{"title":155,"path":156,"stem":157},"Operator CLI","\u002Freference\u002Foperator-cli","9.reference\u002F1.operator-cli",{"title":159,"path":160,"stem":161},"Installer CLI","\u002Freference\u002Finstaller-cli","9.reference\u002F10.installer-cli",{"title":163,"path":164,"stem":165},"Definition syntax","\u002Freference\u002Fdefinition","9.reference\u002F2.definition",{"title":167,"path":168,"stem":169},"CLI configuration","\u002Freference\u002Fconfiguration","9.reference\u002F3.configuration",{"title":171,"path":172,"stem":173},"API integration","\u002Freference\u002Fapi","9.reference\u002F4.api",{"title":175,"path":176,"stem":177},"Action CLI","\u002Freference\u002Faction-cli","9.reference\u002F5.action-cli",{"title":179,"path":180,"stem":181},"Action SDK","\u002Freference\u002Fsdk","9.reference\u002F6.sdk",{"title":183,"path":184,"stem":185},"Contracts and compatibility","\u002Freference\u002Fcontracts","9.reference\u002F7.contracts",{"title":187,"path":188,"stem":189},"Server configuration","\u002Freference\u002Fserver-configuration","9.reference\u002F8.server-configuration",{"title":191,"path":192,"stem":193},"Runner configuration","\u002Freference\u002Frunner-configuration","9.reference\u002F9.runner-configuration",{"id":195,"title":129,"body":196,"description":245,"extension":246,"meta":247,"navigation":248,"path":130,"seo":249,"stem":131,"__hash__":250},"docs\u002F7.administration\u002F5.maintenance.md",{"type":197,"value":198,"toc":238},"minimark",[199,204,208,211,214,218,221,224,228,235],[200,201,203],"h2",{"id":202},"back-up-a-consistent-installation","Back up a consistent installation",[205,206,207],"p",{},"The server data directory contains SQLite, its encryption key, filesystem logs, and JetStream state. Back up the complete directory while the service is stopped. Copying only the database is insufficient; losing the encryption key makes encrypted records unrecoverable.",[205,209,210],{},"Before planned maintenance, prevent new operational work and allow active executions to settle. Drain runners as appropriate, inspect Runs, and then stop the server using your service manager. Back up the complete directory with its ownership and permissions and protect the backup as sensitive data. Preserve runner state separately so owning runners can reconcile their invocations.",[205,212,213],{},"Pyplines has no built-in backup scheduler. Integrate this stopped-service procedure with your organization's backup system and test recovery in an isolated environment that cannot duplicate production Actions.",[200,215,217],{"id":216},"select-versions","Select versions",[205,219,220],{},"Platform and tooling publish independently. The site's supported combination identifies the recommended server\u002Frunner and CLI\u002FSDK versions. A tooling upgrade does not require rebuilding every Action: published Actions carry their own SDK\u002Fruntime, and compatibility depends on their execution contract.",[205,222,223],{},"Keep server and runners on the same platform release. Review the selected release's notes and retained documentation snapshot before upgrading. Do not assume matching numeric platform and tooling versions are required.",[200,225,227],{"id":226},"perform-an-upgrade","Perform an upgrade",[205,229,230,231,234],{},"Follow ",[232,233,57],"a",{"href":58}," for the maintenance sequence, Compose and Linux service commands, migration behavior, and post-upgrade verification. Keep server and runner versions aligned and preserve state during replacement.",[205,236,237],{},"A backup is not permission to replay external effects. Restoring server state can put it behind the real state of external systems. Reconcile those effects and owning runner state before allowing more work. An older binary is not guaranteed to understand a migrated database; plan recovery around a compatible complete backup, not an assumed in-place downgrade.",{"title":239,"searchDepth":240,"depth":240,"links":241},"",2,[242,243,244],{"id":202,"depth":240,"text":203},{"id":216,"depth":240,"text":217},{"id":226,"depth":240,"text":227},"Preserve platform state and maintain a supported component combination.","md",{},true,{"title":129,"description":245},"nkGVDBvY0j3eTB79p2ghEZ20gzdZfyldhU9J1ibOZok",[252,254],{"title":125,"path":126,"stem":127,"description":253,"children":-1},"Manage accounts, team roles, and execution requirements.",{"title":138,"path":139,"stem":140,"description":255,"children":-1},"Scaffold a typed Python Action and execute it locally.",1792213696827]