This page covers iii.worker.yaml configuration options. iii.worker.yaml exists at a worker’s
root and tells iii how to provision the worker’s runtime, install its dependencies, start its
process, and pass through configuration. The engine reads it when starting a worker from
config.yaml and when the
iii worker CLI starts, stops, or restarts a managed worker.For how to connect a worker into a project once its manifest exists, see
Creating Workers / Workers.
iii.worker.yaml only matters when iii provisions and runs the worker in its built-in
virtualization. If you run the worker process yourself, for example node ./myworker/src/index.js
on your own machine, container, or server, you do not need the manifest at all. Any process that
uses a iii SDK, calls registerWorker(), and connects to a iii instance is a worker, and behaves
identically whether iii started it or not.
name
Required. Must satisfy the registry’s worker-name rules (the same validation the registry applies to
published names). A worker cannot list itself in dependencies.
runtime
Declares details about the worker’s environment.
base_image
Optional. Overrides the default OCI rootfs. Must be a valid OCI reference (alphanumerics plus
. _ - / : @ +, max 512 characters). Invalid references are dropped with a warning and the default
is used.
runtime: base_image: oven/bun:1 # From docker.io # Or a fully-qualified registry path, e.g. GitHub Container Registry: # base_image: ghcr.io/astral-sh/uv:bookworm-slim
scripts
Explicit lifecycle scripts. These define how to initialize a worker’s base environment (setup),
install a worker’s dependencies (install), and run a worker whenever it is started or restarted
(start).
When scripts is omitted, the engine infers install and start from runtime.kind and
runtime.package_manager. The per-field examples below show common values for each language.
setup
Runs once when the sandbox is provisioned. Use it for system-level packages your dependencies need
to build.
Map of environment variables injected into the worker process. Keys and values must be strings. The
keys III_URL and III_ENGINE_URL are silently filtered out; the engine sets the connection URL
itself.
env: LOG_LEVEL: info MY_API_KEY: replace-me
dependencies
Map of <worker-name>: <semver range> declaring other workers this worker depends on, resolved
against the registry.
Each name must satisfy the registry’s worker-name validation.
Each range must be a valid semver version requirement (for example ^1.2, ~0.5.0, >=2 <3).
Duplicate keys are an error.
A worker cannot depend on itself.
Prerelease ranges are accepted syntactically, but the default registry resolver serves only stable
versions, so a prerelease range surfaces as version_not_found at resolve time.
resources
Optional CPU and memory requests for the worker’s sandbox. Requests above the cap are clamped to the
cap. For bundle workers this emits a W182 BundleResourceClamped warning at install time.
resources: cpus: 2 memory: 2048
cpus
Optional integer. Number of vCPUs. Defaults to 2, capped at 4.
memory
Optional integer. Memory in MiB. Defaults to 2048, capped at 4096.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"iii","colors":{"primary":"#ff5a1f","light":"#ff7a45","dark":"#3ea8ff"},"logo":{"light":"https://mintcdn.com/motiadev/8Na0wWAHXDq5Krco/assets/iii-black.svg?fit=max\u0026auto=format\u0026n=8Na0wWAHXDq5Krco\u0026q=85\u0026s=21d47f4b3f72a4587aaf659e658ddfa9","dark":"https://mintcdn.com/motiadev/8Na0wWAHXDq5Krco/assets/iii-white.svg?fit=max\u0026auto=format\u0026n=8Na0wWAHXDq5Krco\u0026q=85\u0026s=4efa3e499a04b733ca465a8d5ca8391a"},"favicon":{"light":"https://mintcdn.com/motiadev/gk5vwNRj8-L3TMdW/assets/favicon-black.svg?fit=max\u0026auto=format\u0026n=gk5vwNRj8-L3TMdW\u0026q=85\u0026s=cb7ca2023c970d667241c9efd1aacbd9","dark":"https://mintcdn.com/motiadev/gk5vwNRj8-L3TMdW/assets/favicon-white.svg?fit=max\u0026auto=format\u0026n=gk5vwNRj8-L3TMdW\u0026q=85\u0026s=e64a1e8b9838cd125c12bbea2f59f7cf"},"appearance":{"default":"light"},"background":{"color":{"light":"#f2f0ed","dark":"#111110"}},"navbar":{"links":[{"icon":"discord","href":"https://discord.gg/iiidev","label":"Discord"},{"href":"https://github.com/iii-hq/iii","label":"GitHub","type":"github"}],"primary":{"type":"button","label":"Install","href":"/install"}},"fonts":{"family":"Chivo Mono"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"catppuccin-latte","dark":"dark-plus"}},"latex":true},"integrations":{"gtm":{"tagId":"GTM-N8DCTFB8"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"motiadev","hasAudioNarration":false,"actualSubdomain":"motiadev","customDomains":["iii.dev"],"gitSource":{"type":"github","owner":"iii-hq","repo":"iii","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afde22980aa056f280d5256","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Docs","count":387},{"language":"default","tag":"Using iii","count":131},{"language":"default","tag":"Creating Workers","count":124},{"language":"default","tag":"SDK \u0026 Engine Reference","count":109},{"language":"default","tag":"Documentation","count":107},{"language":"default","tag":"Tutorials","count":84},{"language":"default","tag":"Linkly","count":84},{"language":"default","tag":"Language SDKs","count":58},{"language":"default","tag":"Understanding iii","count":57},{"language":"default","tag":"Getting Started","count":56}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"type":"link","url":"https://discord.gg/iiidev"}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":"/* vietnamese */\n@font-face {\n font-family: 'Chivo Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/chivomono/v11/mFT0WbgRxKvF_Z5eQMO9gxAD1XJ7.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Chivo Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/chivomono/v11/mFT0WbgRxKvF_Z5eQMO9gxED1XJ7.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Chivo Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/chivomono/v11/mFT0WbgRxKvF_Z5eQMO9gx8D1Q.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Chivo Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/chivomono/v11/mFT0WbgRxKvF_Z5eQMO9gxAD1XJ7.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Chivo Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/chivomono/v11/mFT0WbgRxKvF_Z5eQMO9gxED1XJ7.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Chivo Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/chivomono/v11/mFT0WbgRxKvF_Z5eQMO9gx8D1Q.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Chivo Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/chivomono/v11/mFT0WbgRxKvF_Z5eQMO9gxAD1XJ7.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Chivo Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/chivomono/v11/mFT0WbgRxKvF_Z5eQMO9gxED1XJ7.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Chivo Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/chivomono/v11/mFT0WbgRxKvF_Z5eQMO9gx8D1Q.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--iii-bg: #f2f0ed;--iii-panel: #e9e6e2;--iii-paper-2: #ebe8e3;--iii-ink: #0a0a0a;--iii-ink-faint: #6b6865;--iii-ink-ghost: #a3a09c;--iii-rule: #d8d5d0;--iii-rule-2: #e6e3df;--iii-accent: #ff5a1f;--iii-accent-fg: #f2f0ed;--iii-alert: #c43e1c;--iii-warn: #a87a00}html.dark,[data-theme=\"dark\"]{--iii-bg: #111110;--iii-panel: #1a1916;--iii-paper-2: #1f1e1c;--iii-ink: #f2f0ed;--iii-ink-faint: #9c9893;--iii-ink-ghost: #5d5a55;--iii-rule: #2a2926;--iii-rule-2: #1f1e1c;--iii-accent: #3ea8ff;--iii-accent-fg: #111110}html,body{background:var(--iii-bg)!important;color:var(--iii-ink)!important;font-family:\"Chivo Mono\", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\",\n \"Courier New\", monospace!important;font-feature-settings:\"liga\" 0,\n \"clig\" 0,\n \"calt\" 0,\n \"dlig\" 0;scrollbar-gutter:stable}*{border-radius:0!important}::selection{background:var(--iii-accent);color:var(--iii-accent-fg)}::-webkit-scrollbar{width:10px;height:10px}::-webkit-scrollbar-track{background:transparent}::-webkit-scrollbar-thumb{background:var(--iii-rule)}::-webkit-scrollbar-thumb:hover{background:var(--iii-ink-ghost)}body,button,input,textarea,select,code,pre{font-family:\"Chivo Mono\", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\",\n \"Courier New\", monospace!important}a{color:var(--iii-ink)!important;text-decoration-color:var(--iii-rule);text-underline-offset:3px}a:hover{color:var(--iii-accent)!important;text-decoration-color:var(--iii-accent)}header,nav,aside,main,article{background-color:var(--iii-bg)!important}h1,h2,h3,h4,h5,h6{color:var(--iii-ink)!important;font-family:\"Chivo Mono\", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\",\n \"Courier New\", monospace!important;letter-spacing:-0.02em}p,li,td,dd{color:var(--iii-ink-faint)!important;line-height:1.7}strong,th{color:var(--iii-ink)!important;font-weight:600}hr{border-color:var(--iii-rule)!important}pre,kbd{background-color:var(--iii-panel)!important;color:var(--iii-ink)!important;border-color:var(--iii-rule)!important}pre{background:transparent!important;border:0!important;box-shadow:none!important;margin:0!important;padding:0!important}pre code,pre code *{background:transparent!important;border:0!important;padding:0!important}pre code{color:inherit!important}pre,pre code,.code-block [data-line],.code-block .line{font-variant-numeric:tabular-nums;line-height:1.45!important}.code-block{background:var(--iii-panel)!important;border:1px solid var(--iii-rule)!important;box-shadow:none!important}.code-block [data-component-part=\"code-block-root\"]{background:transparent!important;padding:10px 14px!important}.code-block [data-component-part=\"code-block-root\"]>pre{background:transparent!important}.code-block [data-line],.code-block .line,.code-block [class*=\"line\"]{background:transparent!important}.code-block .line.line-highlight{background:#c5e4c0!important}.code-block .line.line-highlight::after,.code-block [data-component-part=\"code-block-root\"]:not(.has-line-numbers) .line.line-highlight::before{background:#c5e4c0!important;border-left-color:#6da46d!important}html.dark .code-block .line.line-highlight,[data-theme=\"dark\"] .code-block .line.line-highlight{background:#3d5e3d!important}html.dark .code-block .line.line-highlight::after,html.dark .code-block [data-component-part=\"code-block-root\"]:not(.has-line-numbers) .line.line-highlight::before,[data-theme=\"dark\"] .code-block .line.line-highlight::after,[data-theme=\"dark\"] .code-block [data-component-part=\"code-block-root\"]:not(.has-line-numbers) .line.line-highlight::before{background:#3d5e3d!important;border-left-color:#8fbf8f!important}:not(pre)>code{background-color:var(--iii-panel)!important;border:1px solid var(--iii-rule-2)!important;color:var(--iii-ink)!important;padding:0.08rem 0.28rem}table{border-collapse:collapse!important;border:1px solid var(--iii-rule)!important;font-variant-numeric:tabular-nums;width:100%}thead{background:var(--iii-panel)!important}th,td{border-color:var(--iii-rule-2)!important;padding:0.9rem 1rem!important;vertical-align:top}th:first-child,td:first-child{min-width:11rem;padding-left:1.25rem!important}#table-of-contents{background:transparent!important;border-left:0!important;color:var(--iii-ink-faint)!important;margin-top:0!important;padding:0!important;width:16.5rem!important}#table-of-contents>div:first-child{color:var(--iii-ink)!important;font-size:12px!important;font-weight:600!important;gap:0.45rem!important;margin-bottom:0.75rem!important}#table-of-contents-content{border-left:1px solid var(--iii-rule)!important;margin:0!important;padding-left:0.875rem!important;position:relative}#table-of-contents .toc-item{margin:0!important;position:relative}#table-of-contents .toc-item:has(>a[aria-current=\"true\"])::before,#table-of-contents .toc-item:has(>a[data-active=\"true\"])::before,#table-of-contents .toc-item:has(>a[class*=\"text-primary\"])::before{background:var(--iii-accent);content:\"\";height:calc(100% - 0.35rem);left:-0.9375rem;position:absolute;top:0.175rem;width:1px}#table-of-contents a{background:transparent!important;border-left:0!important;color:var(--iii-ink-faint)!important;display:flex!important;font-size:12px!important;line-height:1.4!important;padding-block:0.28rem!important;text-decoration:none!important;transition:color 150ms ease;white-space:normal!important}#table-of-contents a:hover,#table-of-contents a[aria-current=\"true\"],#table-of-contents a[data-active=\"true\"],#table-of-contents a[class*=\"text-primary\"]{background:transparent!important;color:var(--iii-ink)!important}blockquote{background:var(--iii-bg)!important;border-left:2px solid var(--iii-accent)!important;color:var(--iii-ink-faint)!important}input,textarea,select{background:var(--iii-bg)!important;border-color:var(--iii-rule)!important;color:var(--iii-ink)!important}button{box-shadow:none!important}a>span.bg-primary-dark{background:var(--iii-ink)!important;border-radius:0!important}a:hover>span.bg-primary-dark{background:var(--iii-bg)!important;opacity:1!important}a:has(>span.bg-primary-dark) span.text-white,a:has(>span.bg-primary-dark) svg{color:var(--iii-bg)!important}a:has(>span.bg-primary-dark):hover span.text-white,a:has(>span.bg-primary-dark):hover svg{color:var(--iii-ink)!important}.iii-live-count{color:var(--iii-ink-faint);font-size:0.9em;font-variant-numeric:tabular-nums;margin-left:0.35rem}[data-fade-overlay]{display:none!important}details,[data-component-part=\"accordion\"],[data-component-part=\"accordion-group\"]>*{background-color:transparent!important;border:1px solid var(--iii-rule-2)!important;box-shadow:none!important;color:var(--iii-ink)!important}details>summary,[data-component-part=\"accordion\"]>[data-component-part=\"accordion-trigger\"],[data-component-part=\"accordion\"]>button:first-child{background-color:var(--iii-panel)!important;color:var(--iii-ink)!important}details[open]>summary,[data-component-part=\"accordion\"][data-state=\"open\"]>[data-component-part=\"accordion-trigger\"],[data-component-part=\"accordion\"][data-state=\"open\"]>button:first-child{border-bottom:1px solid var(--iii-rule-2)!important}details>*:not(summary),[data-component-part=\"accordion-content\"]{background-color:var(--iii-bg)!important}[data-component-part=\"accordion-group\"]{border:0!important}[data-component-part=\"accordion-group\"]>*+*{border-top:0!important}#navbar{transition:transform 200ms ease}html.iii-navbar-hidden #navbar{transform:translateY(-4rem)}#sidebar{transition:top 200ms ease}html.iii-navbar-hidden #sidebar{top:calc(3rem + 0px)!important}#content-side-layout{transition:top 200ms ease,\n height 200ms ease}html.iii-navbar-hidden #content-side-layout{top:5.5rem!important;height:calc(100vh - 5.5rem)!important}#content-area h4{margin-top:1.75rem;margin-bottom:0.75rem}html,body,#content-side-layout,#content-area{overflow-anchor:none}.iii-qs{border:1px solid var(--iii-rule);background:var(--iii-bg);margin:1.5rem 0}.iii-qs-radio{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip-path:inset(50%);white-space:nowrap}.iii-qs-head{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:0.5rem 1rem;border-bottom:1px solid var(--iii-rule);background:var(--iii-panel);padding:0.5rem 1rem}.iii-qs-title{font-size:11px;font-weight:500;letter-spacing:0.06em;text-transform:lowercase;color:var(--iii-ink-faint)}.iii-qs-picker{display:flex;flex-wrap:wrap;align-items:center;gap:0.375rem}.iii-qs-picker-label{font-size:11px;color:var(--iii-ink-faint);margin-right:0.25rem}.iii-qs-pill{border:1px solid var(--iii-rule);background:var(--iii-bg);color:var(--iii-ink-faint);cursor:pointer;font-size:11px;line-height:1;padding:0.3125rem 0.5rem;user-select:none}.iii-qs-pill:hover{color:var(--iii-ink);border-color:var(--iii-ink-ghost)}.iii-qs:has(#qs-llm:focus-visible) .iii-qs-pill[for=\"qs-llm\"],.iii-qs:has(#qs-none:focus-visible) .iii-qs-pill[for=\"qs-none\"],.iii-qs:has(#qs-openai:focus-visible) .iii-qs-pill[for=\"qs-openai\"],.iii-qs:has(#qs-anthropic:focus-visible) .iii-qs-pill[for=\"qs-anthropic\"],.iii-qs:has(#qs-deepseek:focus-visible) .iii-qs-pill[for=\"qs-deepseek\"],.iii-qs:has(#qs-kimi:focus-visible) .iii-qs-pill[for=\"qs-kimi\"],.iii-qs:has(#qs-openrouter:focus-visible) .iii-qs-pill[for=\"qs-openrouter\"],.iii-qs:has(#qs-xai:focus-visible) .iii-qs-pill[for=\"qs-xai\"],.iii-qs:has(#qs-zai:focus-visible) .iii-qs-pill[for=\"qs-zai\"],.iii-qs:has(#qs-github-copilot:focus-visible) .iii-qs-pill[for=\"qs-github-copilot\"],.iii-qs:has(#qs-openai-codex:focus-visible) .iii-qs-pill[for=\"qs-openai-codex\"],.iii-qs:has(#qs-llamacpp:focus-visible) .iii-qs-pill[for=\"qs-llamacpp\"]{outline:2px solid var(--iii-accent);outline-offset:2px}.iii-qs:has(#qs-llm:checked) .iii-qs-pill[for=\"qs-llm\"],.iii-qs:has(#qs-none:checked) .iii-qs-pill[for=\"qs-none\"],.iii-qs:has(#qs-openai:checked) .iii-qs-pill[for=\"qs-openai\"],.iii-qs:has(#qs-anthropic:checked) .iii-qs-pill[for=\"qs-anthropic\"],.iii-qs:has(#qs-deepseek:checked) .iii-qs-pill[for=\"qs-deepseek\"],.iii-qs:has(#qs-kimi:checked) .iii-qs-pill[for=\"qs-kimi\"],.iii-qs:has(#qs-openrouter:checked) .iii-qs-pill[for=\"qs-openrouter\"],.iii-qs:has(#qs-xai:checked) .iii-qs-pill[for=\"qs-xai\"],.iii-qs:has(#qs-zai:checked) .iii-qs-pill[for=\"qs-zai\"],.iii-qs:has(#qs-github-copilot:checked) .iii-qs-pill[for=\"qs-github-copilot\"],.iii-qs:has(#qs-openai-codex:checked) .iii-qs-pill[for=\"qs-openai-codex\"],.iii-qs:has(#qs-llamacpp:checked) .iii-qs-pill[for=\"qs-llamacpp\"]{background:var(--iii-ink);border-color:var(--iii-ink);color:var(--iii-bg)}.iii-qs-body{padding:0.75rem 1rem;font-size:12.5px;line-height:1.7;overflow-x:auto}.iii-qs-comment{color:var(--iii-ink-ghost);font-style:italic;white-space:pre-wrap;overflow-wrap:break-word;user-select:none}.iii-qs-cmd{display:flex;gap:0.5rem;color:var(--iii-ink);white-space:pre-wrap;overflow-wrap:break-word}.iii-qs-cmd a{color:inherit!important;font-weight:inherit!important;text-decoration:none!important;border-bottom:0!important;pointer-events:none}.iii-qs-prompt{color:var(--iii-accent);user-select:none}.iii-qs-gap{height:0.75rem}.iii-qs-slot{display:none}.iii-qs:has(#qs-llm:checked) .iii-qs-slot[data-qs=\"llm\"],.iii-qs:has(#qs-none:checked) .iii-qs-slot[data-qs=\"none\"],.iii-qs:has(#qs-openai:checked) .iii-qs-slot[data-qs=\"openai\"],.iii-qs:has(#qs-anthropic:checked) .iii-qs-slot[data-qs=\"anthropic\"],.iii-qs:has(#qs-deepseek:checked) .iii-qs-slot[data-qs=\"deepseek\"],.iii-qs:has(#qs-kimi:checked) .iii-qs-slot[data-qs=\"kimi\"],.iii-qs:has(#qs-openrouter:checked) .iii-qs-slot[data-qs=\"openrouter\"],.iii-qs:has(#qs-xai:checked) .iii-qs-slot[data-qs=\"xai\"],.iii-qs:has(#qs-zai:checked) .iii-qs-slot[data-qs=\"zai\"],.iii-qs:has(#qs-github-copilot:checked) .iii-qs-slot[data-qs=\"github-copilot\"],.iii-qs:has(#qs-openai-codex:checked) .iii-qs-slot[data-qs=\"openai-codex\"],.iii-qs:has(#qs-llamacpp:checked) .iii-qs-slot[data-qs=\"llamacpp\"]{display:block}"}]}
{"page":{"pagePath":"0-20-0/creating-workers/worker-manifest","slug":"/0-20-0/creating-workers/worker-manifest","pageMetadata":{"title":"Worker manifest","description":"Complete field reference for iii.worker.yaml.","owner":"devrel","type":"reference","href":"/0-20-0/creating-workers/worker-manifest"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Complete field reference for iii.worker.yaml.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This page covers `,_jsx(_components.code,{children:`iii.worker.yaml`}),` configuration options. `,_jsx(_components.code,{children:`iii.worker.yaml`}),` exists at a worker’s\nroot and tells iii how to provision the worker’s runtime, install its dependencies, start its\nprocess, and pass through configuration. The engine reads it when starting a worker from\n`,_jsx(_components.a,{href:`/0-20-0/using-iii/engine#configuration-file-structure`,children:_jsx(_components.code,{children:`config.yaml`})}),` and when the\n`,_jsx(_components.a,{href:`/0-20-0/using-iii/workers`,children:_jsx(_components.code,{children:`iii worker`})}),` CLI starts, stops, or restarts a managed worker.`]}),`\n`,_jsxs(_components.p,{children:[`For how to connect a worker into a project once its manifest exists, see\n`,_jsx(_components.a,{href:`/0-20-0/creating-workers/workers`,children:`Creating Workers / Workers`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`iii.worker.yaml`}),` only matters when iii provisions and runs the worker in its built-in\nvirtualization. If you run the worker process yourself, for example `,_jsx(_components.code,{children:`node ./myworker/src/index.js`}),`\non your own machine, container, or server, you do not need the manifest at all. Any process that\nuses a iii SDK, calls `,_jsx(_components.code,{children:`registerWorker()`}),`, and connects to a iii instance is a worker, and behaves\nidentically whether iii started it or not.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`name`,children:_jsx(_components.code,{children:`name`})}),`\n`,_jsxs(_components.p,{children:[`Required. Must satisfy the registry’s worker-name rules (the same validation the registry applies to\npublished names). A worker cannot list itself in `,_jsx(_components.code,{children:`dependencies`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`runtime`,children:_jsx(_components.code,{children:`runtime`})}),`\n`,_jsx(_components.p,{children:`Declares details about the worker’s environment.`}),`\n`,_jsx(Heading,{level:`3`,id:`base_image`,children:_jsx(_components.code,{children:`base_image`})}),`\n`,_jsxs(_components.p,{children:[`Optional. Overrides the default OCI rootfs. Must be a valid OCI reference (alphanumerics plus\n`,_jsx(_components.code,{children:`. _ - / : @ +`}),`, max 512 characters). Invalid references are dropped with a warning and the default\nis used.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`runtime`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` base_image`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` oven/bun:1`}),_jsx(_components.span,{style:{color:`#7C7F93`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#6A9955`,\"--shiki-dark-font-style\":`inherit`},children:` # From docker.io`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#7C7F93`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#6A9955`,\"--shiki-dark-font-style\":`inherit`},children:` # Or a fully-qualified registry path, e.g. GitHub Container Registry:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#7C7F93`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#6A9955`,\"--shiki-dark-font-style\":`inherit`},children:` # base_image: ghcr.io/astral-sh/uv:bookworm-slim`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`scripts`,children:_jsx(_components.code,{children:`scripts`})}),`\n`,_jsxs(_components.p,{children:[`Explicit lifecycle scripts. These define how to initialize a worker’s base environment (`,_jsx(_components.code,{children:`setup`}),`),\ninstall a worker’s dependencies (`,_jsx(_components.code,{children:`install`}),`), and run a worker whenever it is started or restarted\n(`,_jsx(_components.code,{children:`start`}),`).`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`scripts`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` setup`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"apt-get update \u0026\u0026 apt-get install -y build-essential\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` install`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"npm install\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` start`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"npx tsx src/index.ts\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`scripts`}),` is omitted, the engine infers `,_jsx(_components.code,{children:`install`}),` and `,_jsx(_components.code,{children:`start`}),` from `,_jsx(_components.code,{children:`runtime.kind`}),` and\n`,_jsx(_components.code,{children:`runtime.package_manager`}),`. The per-field examples below show common values for each language.`]}),`\n`,_jsx(_components.p,{children:` `}),`\n`,_jsx(Heading,{level:`3`,id:`setup`,children:_jsx(_components.code,{children:`setup`})}),`\n`,_jsx(_components.p,{children:`Runs once when the sandbox is provisioned. Use it for system-level packages your dependencies need\nto build.`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Node`,numberOfLines:`2`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`scripts`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` setup`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"apt-get update \u0026\u0026 apt-get install -y build-essential\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`2`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`scripts`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` setup`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"apt-get update \u0026\u0026 apt-get install -y libpq-dev\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Rust`,numberOfLines:`2`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`scripts`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` setup`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"apt-get update \u0026\u0026 apt-get install -y pkg-config libssl-dev\"`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`install`,children:_jsx(_components.code,{children:`install`})}),`\n`,_jsx(_components.p,{children:`Installs dependencies.`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Node`,numberOfLines:`2`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`scripts`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` install`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"npm install\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`2`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`scripts`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` install`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"pip install watchfiles \u0026\u0026 pip install -e .\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Rust`,numberOfLines:`2`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`scripts`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` install`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"cargo install cargo-watch \u0026\u0026 cargo build\"`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`start`,children:_jsx(_components.code,{children:`start`})}),`\n`,_jsx(_components.p,{children:`Starts the worker process.`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Node`,numberOfLines:`2`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`scripts`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` start`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"npx tsx watch src/index.ts\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`2`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`scripts`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` start`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"watchfiles 'python main.py'\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Rust`,numberOfLines:`2`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`scripts`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` start`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"cargo watch -x run\"`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`env`,children:_jsx(_components.code,{children:`env`})}),`\n`,_jsxs(_components.p,{children:[`Map of environment variables injected into the worker process. Keys and values must be strings. The\nkeys `,_jsx(_components.code,{children:`III_URL`}),` and `,_jsx(_components.code,{children:`III_ENGINE_URL`}),` are silently filtered out; the engine sets the connection URL\nitself.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`env`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` LOG_LEVEL`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` info`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` MY_API_KEY`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` replace-me`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`dependencies`,children:_jsx(_components.code,{children:`dependencies`})}),`\n`,_jsxs(_components.p,{children:[`Map of `,_jsx(_components.code,{children:`\u003cworker-name>: \u003csemver range>`}),` declaring other workers this worker depends on, resolved\nagainst the registry.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`dependencies`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` iii-http`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"^0.20\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` iii-state`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#40A02B`,\"--shiki-dark\":`#CE9178`},children:` \"^0.20\"`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Rules:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Each name must satisfy the registry’s worker-name validation.`}),`\n`,_jsxs(_components.li,{children:[`Each range must be a valid semver version requirement (for example `,_jsx(_components.code,{children:`^1.2`}),`, `,_jsx(_components.code,{children:`~0.5.0`}),`, `,_jsx(_components.code,{children:`>=2 \u003c3`}),`).`]}),`\n`,_jsx(_components.li,{children:`Duplicate keys are an error.`}),`\n`,_jsx(_components.li,{children:`A worker cannot depend on itself.`}),`\n`,_jsxs(_components.li,{children:[`Prerelease ranges are accepted syntactically, but the default registry resolver serves only stable\nversions, so a prerelease range surfaces as `,_jsx(_components.code,{children:`version_not_found`}),` at resolve time.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`resources`,children:_jsx(_components.code,{children:`resources`})}),`\n`,_jsxs(_components.p,{children:[`Optional CPU and memory requests for the worker’s sandbox. Requests above the cap are clamped to the\ncap. For bundle workers this emits a `,_jsx(_components.code,{children:`W182 BundleResourceClamped`}),` warning at install time.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes catppuccin-latte dark-plus`,style:{backgroundColor:`#eff1f5`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#4c4f69`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:`resources`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` cpus`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#FE640B`,\"--shiki-dark\":`#B5CEA8`},children:` 2`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1E66F5`,\"--shiki-dark\":`#569CD6`},children:` memory`}),_jsx(_components.span,{style:{color:`#179299`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#FE640B`,\"--shiki-dark\":`#B5CEA8`},children:` 2048`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`cpus`,children:_jsx(_components.code,{children:`cpus`})}),`\n`,_jsxs(_components.p,{children:[`Optional integer. Number of vCPUs. Defaults to `,_jsx(_components.code,{children:`2`}),`, capped at `,_jsx(_components.code,{children:`4`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`memory`,children:_jsx(_components.code,{children:`memory`})}),`\n`,_jsxs(_components.p,{children:[`Optional integer. Memory in MiB. Defaults to `,_jsx(_components.code,{children:`2048`}),`, capped at `,_jsx(_components.code,{children:`4096`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"catppuccin-latte","dark":"dark-plus"}},"config":{},"pageMetadata":{"title":"Worker manifest","description":"Complete field reference for iii.worker.yaml.","owner":"devrel","type":"reference","href":"/0-20-0/creating-workers/worker-manifest"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"name","slug":"name","depth":2,"children":[]},{"title":"runtime","slug":"runtime","depth":2,"children":[{"title":"base_image","slug":"base_image","depth":3,"children":[]}]},{"title":"scripts","slug":"scripts","depth":2,"children":[{"title":"setup","slug":"setup","depth":3,"children":[]},{"title":"install","slug":"install","depth":3,"children":[]},{"title":"start","slug":"start","depth":3,"children":[]}]},{"title":"env","slug":"env","depth":2,"children":[]},{"title":"dependencies","slug":"dependencies","depth":2,"children":[]},{"title":"resources","slug":"resources","depth":2,"children":[{"title":"cpus","slug":"cpus","depth":3,"children":[]},{"title":"memory","slug":"memory","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/motiadev/49b6cc19c4eb61eb/navbar-counters.js","/docs/_mintlify/custom/motiadev/2b6f9c16a390a08d/tutorials/linkly/_workspace/browser-stand-in/confirm.js","/docs/_mintlify/custom/motiadev/bfbf92327c65b453/0-24-0/tutorials/linkly/_workspace/browser-stand-in/confirm.js","/docs/_mintlify/custom/motiadev/9eb8920ead5016c0/tutorials/linkly/_workspace/browser-stand-in/live-clicks.js","/docs/_mintlify/custom/motiadev/886de27e980a1999/0-25-0/tab-anchor.js","/docs/_mintlify/custom/motiadev/47895b17ff9a7270/0-25-0/tutorials/linkly/_workspace/browser-stand-in/confirm.js","/docs/_mintlify/custom/motiadev/b66b90d6865d6a93/0-25-0/tutorials/linkly/_workspace/browser-stand-in/live-clicks.js"],"subdomain":"motiadev","siteName":"iii","title":"Worker manifest - iii","navMaps":{"firstHrefInVersion":{"0.27.x":{"href":"/next/creating-workers/worker-manifest","matchLevel":1},"0.26.x":{"href":"/creating-workers/worker-manifest","matchLevel":1},"0.25.x":{"href":"/0-25-0/creating-workers/worker-manifest","matchLevel":1},"0.24.x":{"href":"/0-24-0/creating-workers/worker-manifest","matchLevel":1},"0.23.x":{"href":"/0-23-0/creating-workers/worker-manifest","matchLevel":1},"0.22.x":{"href":"/0-22-0/creating-workers/worker-manifest","matchLevel":1},"0.21.x":{"href":"/0-21-0/creating-workers/worker-manifest","matchLevel":1},"0.20.x":{"href":"/0-20-0/creating-workers/worker-manifest","matchLevel":0},"0.19.x":{"href":"/0-19-0/creating-workers/worker-manifest","matchLevel":1},"0.18.x":{"href":"/0-18-0/creating-workers/index","matchLevel":2},"0.17.x":{"href":"/0-17-0/creating-workers/index","matchLevel":2},"0.16.x":{"href":"/0-16-0/creating-workers/index","matchLevel":2},"0.13.x":{"href":"/0-13-0/creating-workers/workers","matchLevel":2},"0.12.x":{"href":"/0-12-0/creating-workers/workers","matchLevel":2},"0.11.x":{"href":"/0-11-0","matchLevel":4},"0.10.x":{"href":"/0-10-0","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-08-17T11:36:05.064Z","originalFileLocation":"0-20-0/creating-workers/worker-manifest.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Complete field reference for iii.worker.yaml.\">\u003cmeta data-mint-head name=\"application-name\" content=\"iii\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/motiadev/HFVzzl_H-E1C8o8X/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/motiadev/HFVzzl_H-E1C8o8X/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/motiadev/HFVzzl_H-E1C8o8X/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/motiadev/HFVzzl_H-E1C8o8X/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/motiadev/HFVzzl_H-E1C8o8X/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/motiadev/HFVzzl_H-E1C8o8X/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/motiadev/HFVzzl_H-E1C8o8X/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/motiadev/HFVzzl_H-E1C8o8X/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/motiadev/HFVzzl_H-E1C8o8X/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Worker manifest - iii\">\u003cmeta data-mint-head property=\"og:description\" content=\"Complete field reference for iii.worker.yaml.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"iii\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://iii.dev/docs/0-20-0/creating-workers/worker-manifest\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://motiadev.mintlify.site/docs/_mintlify/api/og/v2?division=Creating+Workers\u0026amp;title=Worker+manifest\u0026amp;description=Complete+field+reference+for+iii.worker.yaml.\u0026amp;theme=4f829b1cc78586d79e124eb7\u0026amp;signature=26916e61072f5d5377eb0f99c71321641d787fff62ab7efa9133ab65a0108082\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Worker manifest - iii\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Complete field reference for iii.worker.yaml.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://motiadev.mintlify.site/docs/_mintlify/api/og/v2?division=Creating+Workers\u0026amp;title=Worker+manifest\u0026amp;description=Complete+field+reference+for+iii.worker.yaml.\u0026amp;theme=4f829b1cc78586d79e124eb7\u0026amp;signature=26916e61072f5d5377eb0f99c71321641d787fff62ab7efa9133ab65a0108082\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/motiadev/HFVzzl_H-E1C8o8X/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"iii\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff5a1f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://iii.dev/docs/0-20-0/creating-workers/worker-manifest\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/0-20-0/creating-workers/worker-manifest.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://iii.dev/#organization\",\"name\":\"iii\",\"url\":\"https://iii.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/motiadev/8Na0wWAHXDq5Krco/assets/iii-black.svg?fit=max\u0026auto=format\u0026n=8Na0wWAHXDq5Krco\u0026q=85\u0026s=21d47f4b3f72a4587aaf659e658ddfa9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://iii.dev/docs#website\",\"name\":\"iii\",\"url\":\"https://iii.dev/docs\",\"publisher\":{\"@id\":\"https://iii.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://iii.dev/docs/0-20-0/creating-workers/worker-manifest#webpage\",\"url\":\"https://iii.dev/docs/0-20-0/creating-workers/worker-manifest\",\"name\":\"Worker manifest\",\"description\":\"Complete field reference for iii.worker.yaml.\",\"dateModified\":\"2026-08-17T11:36:05.064Z\",\"isPartOf\":{\"@id\":\"https://iii.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://iii.dev/docs/0-20-0/creating-workers/worker-manifest#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://iii.dev/docs/0-20-0/creating-workers/worker-manifest#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Creating Workers\",\"item\":\"https://iii.dev/docs/0-20-0/creating-workers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Worker manifest\",\"item\":\"https://iii.dev/docs/0-20-0/creating-workers/worker-manifest\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://iii.dev/docs/0-20-0/creating-workers/worker-manifest#article\",\"headline\":\"Worker manifest\",\"name\":\"Worker manifest\",\"description\":\"Complete field reference for iii.worker.yaml.\",\"url\":\"https://iii.dev/docs/0-20-0/creating-workers/worker-manifest\",\"mainEntityOfPage\":{\"@id\":\"https://iii.dev/docs/0-20-0/creating-workers/worker-manifest#webpage\"},\"dateModified\":\"2026-08-17T11:36:05.064Z\",\"publisher\":{\"@id\":\"https://iii.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://iii.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"iii\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"iii\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/0-20-0/creating-workers/worker-manifest.md","siteName":"iii","nav":{"global":null,"versions":[{"version":"0.27.x","tag":"Next","pages":[{"title":"0.27.x","href":"/next/creating-workers/worker-manifest"}]},{"version":"0.26.x","default":true,"tag":"Latest","pages":[{"title":"0.26.x","href":"/creating-workers/worker-manifest"}]},{"version":"0.25.x","pages":[{"title":"0.25.x","href":"/0-25-0/creating-workers/worker-manifest"}]},{"version":"0.24.x","pages":[{"title":"0.24.x","href":"/0-24-0/creating-workers/worker-manifest"}]},{"version":"0.23.x","pages":[{"title":"0.23.x","href":"/0-23-0/creating-workers/worker-manifest"}]},{"version":"0.22.x","pages":[{"title":"0.22.x","href":"/0-22-0/creating-workers/worker-manifest"}]},{"version":"0.21.x","pages":[{"title":"0.21.x","href":"/0-21-0/creating-workers/worker-manifest"}]},{"version":"0.20.x","tabs":[{"tab":"Docs","groups":[{"group":"Getting Started","pages":[{"title":"Welcome to iii","href":"/0-20-0"},{"title":"Install","href":"/0-20-0/install"},{"title":"Quickstart","href":"/0-20-0/quickstart"},{"title":"Troubleshooting","href":"/0-20-0/troubleshooting"}]},{"group":"Upgrading","pages":[{"title":"Upgrading from 0.19.x to 0.20.x","href":"/0-20-0/upgrading/from-0-19-x"}]},{"group":"Using iii","pages":[{"title":"Workers","href":"/0-20-0/using-iii/workers"},{"title":"Worker Registry","href":"/0-20-0/using-iii/workers-registry"},{"title":"Triggers","href":"/0-20-0/using-iii/triggers"},{"title":"Functions","href":"/0-20-0/using-iii/functions"},{"title":"Engine","href":"/0-20-0/using-iii/engine"},{"title":"Console","href":"/0-20-0/using-iii/console"},{"title":"CLI","href":"/0-20-0/using-iii/cli"},{"title":"Deployment","href":"/0-20-0/using-iii/deployment"}]},{"group":"Understanding iii","expanded":false,"pages":[{"title":"Workers, Triggers, and Functions","href":"/0-20-0/understanding-iii/index"},{"title":"Engine","href":"/0-20-0/understanding-iii/engine"},{"title":"Channels","href":"/0-20-0/understanding-iii/channels"}]},{"group":"Creating Workers","pages":[{"title":"Overview","href":"/0-20-0/creating-workers/index"},{"group":"Common Workers","pages":[{"title":"HTTP","href":"/0-20-0/creating-workers/http"},{"title":"Queues","href":"/0-20-0/creating-workers/queues"},{"title":"Observability","href":"/0-20-0/creating-workers/observability"},{"title":"Sandboxes","href":"/0-20-0/creating-workers/sandboxes"},{"title":"Access Control","href":"/0-20-0/creating-workers/worker-manager"}]},{"title":"Workers","description":"Deploying and integrating workers into a iii project.","href":"/0-20-0/creating-workers/workers"},{"title":"Worker manifest","href":"/0-20-0/creating-workers/worker-manifest"},{"title":"Triggers","description":"Author new trigger types so other workers' functions can run on the events your worker emits.","href":"/0-20-0/creating-workers/triggers"},{"title":"Functions","href":"/0-20-0/creating-workers/functions"},{"title":"Channels","href":"/0-20-0/creating-workers/channels"}]}]},{"tab":"Tutorials","pages":[{"title":"Tutorials","href":"/0-20-0/tutorials/linkly/overview"}]},{"tab":"SDK \u0026 Engine Reference","pages":[{"title":"SDK \u0026 Engine Reference","href":"/0-20-0/sdk-reference/engine-sdk"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},{"version":"0.19.x","pages":[{"title":"0.19.x","href":"/0-19-0/creating-workers/worker-manifest"}]},{"version":"0.18.x","pages":[{"title":"0.18.x","href":"/0-18-0/creating-workers"}]},{"version":"0.17.x","pages":[{"title":"0.17.x","href":"/0-17-0/creating-workers"}]},{"version":"0.16.x","pages":[{"title":"0.16.x","href":"/0-16-0/creating-workers"}]},{"version":"0.13.x","pages":[{"title":"0.13.x","href":"/0-13-0/creating-workers/workers"}]},{"version":"0.12.x","pages":[{"title":"0.12.x","href":"/0-12-0/creating-workers/workers"}]},{"version":"0.11.x","pages":[{"title":"0.11.x","href":"/0-11-0"}]},{"version":"0.10.x","pages":[{"title":"0.10.x","href":"/0-10-0"}]}]},"basePath":"","title":"Worker manifest - iii","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":[],"chunks":[]}