[{"data":1,"prerenderedAt":415},["ShallowReactive",2],{"navigation":3,"\u002Freference\u002Fconfiguration":194,"\u002Freference\u002Fconfiguration-surround":410},[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":167,"body":196,"description":404,"extension":405,"meta":406,"navigation":407,"path":168,"seo":408,"stem":169,"__hash__":409},"docs\u002F9.reference\u002F3.configuration.md",{"type":197,"value":198,"toc":399},"minimark",[199,204,241,256,259,263,338,349,353,372,381,395],[200,201,203],"h2",{"id":202},"server-and-tls-settings","Server and TLS settings",[205,206,212],"pre",{"className":207,"code":208,"filename":209,"language":210,"meta":211,"style":211},"language-sh shiki shiki-themes pyplines-light pyplines-light pyplines-dark","pyplines config set server https:\u002F\u002Fpyplines.example.com\npyplines config set tls.ca_file \u002Fabsolute\u002Fpath\u002Fcompany-ca.pem\npyplines config get tls.ca_file\npyplines config show\n","Terminal","sh","",[213,214,215,223,229,235],"code",{"__ignoreMap":211},[216,217,220],"span",{"class":218,"line":219},"line",1,[216,221,222],{},"pyplines config set server https:\u002F\u002Fpyplines.example.com\n",[216,224,226],{"class":218,"line":225},2,[216,227,228],{},"pyplines config set tls.ca_file \u002Fabsolute\u002Fpath\u002Fcompany-ca.pem\n",[216,230,232],{"class":218,"line":231},3,[216,233,234],{},"pyplines config get tls.ca_file\n",[216,236,238],{"class":218,"line":237},4,[216,239,240],{},"pyplines config show\n",[242,243,244,247,248,251,252,255],"p",{},[213,245,246],{},"server"," and ",[213,249,250],{},"tls.ca_file"," are the supported configuration keys. ",[213,253,254],{},"config unset KEY"," removes a saved value. An additional CA supplements system trust; TLS and hostname verification remain enabled.",[242,257,258],{},"The operator CLI and API client use system trust. If your server certificate is issued by a trusted CA, no CA override is needed.",[200,260,262],{"id":261},"precedence","Precedence",[264,265,266,279],"table",{},[267,268,269],"thead",{},[270,271,272,276],"tr",{},[273,274,275],"th",{},"Value",[273,277,278],{},"Order, highest priority first",[280,281,282,301,312,324],"tbody",{},[270,283,284,288],{},[285,286,287],"td",{},"Server for API requests",[285,289,290,291,294,295,298,299],{},"Global ",[213,292,293],{},"--server",", ",[213,296,297],{},"PYPLINES_SERVER",", saved ",[213,300,246],{},[270,302,303,306],{},[285,304,305],{},"Token",[285,307,308,311],{},[213,309,310],{},"PYPLINES_TOKEN",", saved session for the selected server",[270,313,314,317],{},[285,315,316],{},"Additional CA",[285,318,319,298,322],{},[213,320,321],{},"PYPLINES_CA_FILE",[213,323,250],{},[270,325,326,329],{},[285,327,328],{},"Configuration directory",[285,330,331,334,335],{},[213,332,333],{},"PYPLINES_CONFIG_DIR",", otherwise ",[213,336,337],{},"~\u002F.pyplines",[242,339,340,343,344,247,346,348],{},[213,341,342],{},"login URL"," explicitly selects and saves its supplied server. For automation, inject ",[213,345,297],{},[213,347,310],{}," through your existing credential delivery system. Do not put tokens into Definitions or commit them alongside configuration.",[200,350,352],{"id":351},"session-storage","Session storage",[242,354,355,356,359,360,363,364,367,368,371],{},"Settings are stored in ",[213,357,358],{},"config.json","; tokens are stored separately in ",[213,361,362],{},"sessions.json",", keyed by server URL. Passwords are not saved. Tokens are stored unencrypted. On Unix, the directory has mode ",[213,365,366],{},"0700"," and files ",[213,369,370],{},"0600","; on Windows they inherit the user profile's access controls. Exclude sessions from shared backups.",[242,373,374,377,378,380],{},[213,375,376],{},"logout"," attempts server revocation and removes the local token even if that server is unreachable. A token supplied through ",[213,379,310],{}," remains in its external source until you remove or replace it there.",[242,382,383,384,387,388,391,392,394],{},"Older settings at ",[213,385,386],{},"~\u002F.config\u002Fpyplines\u002Fconfig.json"," remain readable until configuration is saved at the new location. Earlier ",[213,389,390],{},"ca_file"," settings are interpreted as ",[213,393,250],{},". Old keychain sessions are no longer read; log in again to create a file-based session.",[396,397,398],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}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);}",{"title":211,"searchDepth":225,"depth":225,"links":400},[401,402,403],{"id":202,"depth":225,"text":203},{"id":261,"depth":225,"text":262},{"id":351,"depth":225,"text":352},"Server selection, TLS trust, sessions, and noninteractive clients.","md",{},true,{"title":167,"description":404},"_4j5g5_y2oVkVVThyg7RHvmHqpimt0-iZyNiLdbIduA",[411,413],{"title":163,"path":164,"stem":165,"description":412,"children":-1},"Fields, expressions, and limits for the pyplines\u002Fv1 contract.",{"title":171,"path":172,"stem":173,"description":414,"children":-1},"Use the same API as the operator CLI for external automation.",1792213697777]