Golem Application Manifest Reference

Optional manifest schema version string.

Optional list of glob patterns that are used for adding search patterns for other Application Manifests when using auto discovery of them. The patterns are relative to the manifest document in which they are defined.

The default search pattern is **/golem.yaml, which searches for golem.yaml documents in every subdirectory recursively. Templates and examples provided by Golem usually use more specific search patterns to make the lookups more efficient.

The includes fields can be defined in one manifest only, usually in the project root directory. Defining it multiple times results in validation error.

includes:
- components-dir/*/golem.yaml
- custom-templates/golem-*.yaml

Required application name which will be used as the deployment name for the application.

Optional object for defining HTTP API deployments. Deployments can be defined in multiple manifests, and they are merged during deployment.

Optional map of HTTP API deployments by environment name.

Optional list of HTTP API deployments for the environment.

Required domain for the deployment.

Optional webhook URL for the deployment.

Optional map of HTTP API deployment options by agent type name.

Optional security scheme for the agent in this deployment.

Optional test session header name for the agent in this deployment.

Optional object for defining MCP deployments.

Optional map of MCP deployments by environment name.

Optional list of MCP deployments for the environment.

Required domain for the MCP deployment.

Optional map of MCP deployment options by agent type name.

Optional security scheme for the agent in this MCP deployment.

Optional application environments by environment name.

Optional boolean which when set to true marks the environment as default. Only one environment can be marked as default. If missing, the first environment is used as default.

Optional account that owns the application environment. When not specified then the current user will be used.

Optional server configuration for the environment. Accepted values:

• local

  available since1.1.0
• cloud

  available since1.1.0

or a custom server object with the fields documented below.

Required URL for custom servers.

Optional custom URL for golem worker service.

Optional boolean which defaults to false, when set to true it allows insecure connections to the server.

Optional boolean which when set to true selects OAuth2 based authentication.

Optional string static token for authentication when using static token based authentication.

Optional preset name or list of preset names which will be used for the application in the given environment.

Optional default format for the environment, accepted values:

• text(default value)

  available since1.1.0
• json

  available since1.1.0
• pretty-json

  available since1.1.0
• pretty

  available since1.1.0

  alias for pretty-json
• yaml

  available since1.1.0
• pretty-yaml

  available since1.1.0

Optional boolean which when set enables the auto-confirm (yes) flag by default.

Optional boolean which when set enables redeploy-agents flag by default.

Optional boolean which when set enables reset flag by default.

Optional boolean to enable compatibility checks during deployment.

Optional boolean to enable version checks during deployment.

Optional boolean to allow security overrides during deployment.

Optional map of Golem components indexed by component-name-s used for defining components.

The components field can be defined in multiple manifest documents, but the used component-name-s must be unique across all the used manifest documents. Using the same component-name more then once results in validation error.

components:
  pack-ns:component-name:
    componentWasm: # ...
    # ...
  pack:comp-b:
    componentWasm: # ...
    # ...

Optional template name or list of template names which will be used for creating the component fields.

The template name must be one of that are defined in componentTemplates.

See componentTemplates and Template variable and functions for defining templates.

Optional map of presets used to define preset variations for a component.

A preset contains the same fields as a component. Presets can also specify a components.<component-name>.presets.<preset-name>.default flag to mark it as the default preset for selection.

Preset specific components.<component-name>.default.

Optional boolean which when set to true marks the preset as the default for selection.

Optional base directory for resolving component paths. The path is relative to the manifest document.

Optional merge mode for components.<component-name>.build. Accepted values:

• append(default value)

  available since1.1.0
• prepend

  available since1.1.0
• replace

  available since1.1.0

Optional list of files entries, which can be used for defining the Initial File System for the component.

components:
  pack-ns:component-name:
    # ...
    files:
    - sourcePath: ./files/foo.txt
      targetPath: /files/foo.txt
      permissions: read-only
    - sourcePath: ./files/bar.txt
      targetPath: /files/bar.txt
      permissions: read-write

Optional merge mode for components.<component-name>.files. Accepted values:

• append(default value)

  available since1.1.0
• prepend

  available since1.1.0
• replace

  available since1.1.0

Required source path of the file to be added to the Initial File System. The path can be a file path relative to the manifest document or an URL.

Required target path of the file in the Initial File System. The path must be an absolute path.

Optional string enum which controls file permissions. Accepted values:

• read-only(default value)

  available since1.1.0
• read-write

  available since1.1.0

Optional list of component plugin installation entries,

Optional merge mode for components.<component-name>.plugins. Accepted values:

• append(default value)

  available since1.1.0
• prepend

  available since1.1.0
• replace

  available since1.1.0

Required name of the plugin.

Required version of the plugin.

Optional account used for installing the plugin.

Optional string map of plugin parameters.

Optional configuration for the component.

Optional string map of environment variables for the component.

Optional merge mode for components.<component-name>.env. Accepted values:

• upsert(default value)

  available since1.1.0
• replace

  available since1.1.0
• remove

  available since1.1.0

Optional string map of WASI configuration variables for the component.

Optional merge mode for components.<component-name>.wasiConfig. Accepted values:

• upsert(default value)

  available since1.1.0
• replace

  available since1.1.0
• remove

  available since1.1.0

Optional file path for the built WASM component.

The path is relative to the manifest document in which the field is defined.

components:
  pack-ns:component-name:
    # ...
    componentWasm: build/component.wasm

Optional file path for the output WASM component which is ready to be uploaded to Golem.

The path is relative to the manifest document in which the field is defined.

components:
  pack-ns:component-name:
    # ...
    outputWasm: build/output.wasm

Optional list of build steps that creates components.<component-name>.componentWasm.

Each build step can be one of:

• an external command (with command field)
• a QuickJS crate generation step (with generateQuickjsCrate field)
• a QuickJS d.ts generation step (with generateQuickjsDts field)
• an inject to prebuilt QuickJS step (with injectToPrebuiltQuickjs field)
• a JS preinitialization step (with preinitializeJs field)

components:
  pack-ns:component-name:
    build:
    - command: bindgen-tool src component.wasm
    - command: build-tool src component.wasm

Required external command that will be used as a build step for creating components.<component-name>.componentWasm.

Optional directory path which will be used as working directory when executing components.<component-name>.build[*].command.

The path is relative to the manifest document, and defaults to ..

Optional string map of environment variables for the build command.

Optional list of directory paths which will be deleted before executing the command.

The path is relative to components.<component-name>.build[*].dir.

The rmdirs field is useful when a binding generator does not automatically clean stale bindings.

Directories are not removed if the command is skipped because of up-to-date checks, see components.<component-name>.build[*].sources and components.<component-name>.build[*].targets.

Directories are removed before executing components.<component-name>.build[*].mkdirs.

Optional list of directory paths which will be created before executing the command if they do not exists.

The path is relative to components.<component-name>.build[*].dir.

The mkdirs field is useful when a build of binding generator tool does not automatically create required nested folders.

Directories are not created if the command is skipped because of up-to-date checks, see components.<component-name>.build[*].sources and components.<component-name>.build[*].targets.

Directories are created after executing components.<component-name>.build[*].rmdirs.

Optional list of paths and globs which are used as sources for performing up-to-date checks.

If defined then components.<component-name>.build[*].targets also have to be used.

The up-to-date check

• skips executing components.<component-name>.build[*].command
• if all matching files defined by components.<component-name>.build[*].targets
• are newer then the matched files defined by sources.

components:
  pack-ns:component-name:
    # ...
    build:
    - command: build-tool src-dir out.wasm
      sources:
      - src-dir/*
      targets:
      - out.wasm

Optional list of paths and globs which are used as targets for performing up-to-date checks.

If defined then components.<component-name>.build[*].sources also have to be used.

See components.<component-name>.build[*].sources for up-to-date check details.

Optional map of component specific external commands, which are useful for defining e.g. one time installation or update related commands for the component.

The commands can be executed using:

golem exec command-name

Multiple components can use the same command-name, the above command will execute all matching commands in this case, both component specific and project ones.

For defining project level custom commands see customCommands.

components:
  pack-ns:component-name:
    # ...
    customCommands:
      npm-install:
      - command: npm install

Component specific customCommands.<command-name>[*].dir.

Component specific customCommands.<command-name>[*].env.

Component specific customCommands.<command-name>[*].rmdirs.

Component specific customCommands.<command-name>[*].mkdirs.

Component specific customCommands.<command-name>[*].mkdirs.

Component specific customCommands.<command-name>[*].sources.

Component specific customCommands.<command-name>[*].targets.

Component specific clean.

Optional list of paths which are added as targets to the golem clean command.

The paths are relative to the manifest document.

The clean command deletes the following paths:

• build and custom command targets
• the paths defined in common and component specific clean fields.

Optional map of custom external commands, which are useful for defining e.g. one time installation or update related project commands.

The commands can be executed using:

golem exec command-name

Components specific custom commands can use the same command-name, the above command will execute all matching commands in this case, both component specific and project ones.

For defining component specific custom commands see components.<component-name>.customCommands.

customCommands:
  npm-install:
  - command: npm install

Optional directory path which will be used as working directory when executing customCommands.<command-name>[*].command.

The path is relative to the manifest document, and defaults to ..

Optional string map of environment variables for the command.

Optional list of directory paths which will be deleted before executing the command.

The path is relative to customCommands.<command-name>[*].dir.

The rmdirs field is useful when a binding generator does not automatically clean stale bindings.

Directories are not removed if the command is skipped because of up-to-date checks, see customCommands.<command-name>[*].sources and customCommands.<command-name>[*].targets.

Directories are removed before executing customCommands.<command-name>[*].mkdirs.

Optional list of directory paths which will be created before executing the command if they do not exists.

The path is relative to customCommands.<command-name>[*].dir.

The mkdirs field is useful when a build of binding generator tool does not automatically create required nested folders.

Directories are not created if the command is skipped because of up-to-date checks, see customCommands.<command-name>[*].sources and customCommands.<command-name>[*].targets.

Directories are created after executing customCommands.<command-name>[*].rmdirs.

Optional list of paths and globs which are used as sources for performing up-to-date checks.

If defined then customCommands.<command-name>[*].targets also have to be used.

The up-to-date check

• skips executing customCommands.<command-name>[*].command
• if all matching files defined by customCommands.<command-name>[*].targets
• are newer then the matched files defined by sources.

Optional list of paths and globs which are used as targets for performing up-to-date checks.

If defined then customCommands.<command-name>[*].sources also have to be used.

See customCommands.<command-name>[*].sources for up-to-date check details.

Optional map of named templates, which can be used in components.<component-name>.templates.

Templates help in extracting common build patterns and reuse them for multiple components.

The templates field can be defined in multiple application manifest documents, but the template names must be unique.

See Template variable and functions for more information about templating.

Templated components.<component-name>.componentWasm.

Templated components.<component-name>.outputWasm.

Templated components.<component-name>.buildMergeMode.

Templated components.<component-name>.build.

Templated components.<component-name>.build[*].command.

Templated components.<component-name>.build[*].dir.

Templated components.<component-name>.build[*].env.

Templated components.<component-name>.build[*].rmdirs.

Templated components.<component-name>.build[*].mkdirs.

Templated components.<component-name>.build[*].sources.

Templated components.<component-name>.build[*].targets.

Templated components.<component-name>.customCommands.

Templated components.<component-name>.customCommands.<command-name>[*].dir.

Templated components.<component-name>.customCommands.<command-name>[*].env.

Templated components.<component-name>.customCommands.<command-name>[*].rmdirs.

Templated components.<component-name>.customCommands.<command-name>[*].mkdirs.

Templated components.<component-name>.customCommands.<command-name>[*].sources.

Templated components.<component-name>.customCommands.<command-name>[*].targets.

Templated components.<component-name>.clean.

Templated components.<component-name>.config.

Templated components.<component-name>.env.

Templated components.<component-name>.envMergeMode.

Templated components.<component-name>.wasiConfig.

Templated components.<component-name>.wasiConfigMergeMode.

Templated components.<component-name>.plugins.

Templated components.<component-name>.pluginsMergeMode.

Templated components.<component-name>.files.

Templated components.<component-name>.filesMergeMode.

Templated components.<component-name>.files[*].sourcePath.

Templated components.<component-name>.files[*].targetPath.

Templated components.<component-name>.files[*].permissions.

Templated components.<component-name>.presets.

Templated and preset specific components.<component-name>.default.

Optional map of agents by agent type name.

Optional template name or list of template names which will be used for creating the agent fields.

Optional configuration for the agent.

Optional string map of environment variables for the agent.

Optional merge mode for agents.<agent-type-name>.env. Accepted values:

• upsert(default value)

  available since1.1.0
• replace

  available since1.1.0
• remove

  available since1.1.0

Optional string map of WASI configuration variables for the agent.

Optional merge mode for agents.<agent-type-name>.wasiConfig. Accepted values:

• upsert(default value)

  available since1.1.0
• replace

  available since1.1.0
• remove

  available since1.1.0

Optional list of plugin installations for the agent.

Optional merge mode for agents.<agent-type-name>.plugins. Accepted values:

• append(default value)

  available since1.1.0
• prepend

  available since1.1.0
• replace

  available since1.1.0

Required name of the plugin.

Required version of the plugin.

Optional account used for installing the plugin.

Optional string map of plugin parameters.

Optional list of files entries for defining the Initial File System for the agent.

Optional merge mode for agents.<agent-type-name>.files. Accepted values:

• append(default value)

  available since1.1.0
• prepend

  available since1.1.0
• replace

  available since1.1.0

Required source path of the file. The path can be a file path relative to the manifest document or an URL.

Required target path of the file. The path must be an absolute path.

Optional string enum which controls file permissions. Accepted values:

• read-only(default value)

  available since1.1.0
• read-write

  available since1.1.0

Optional map of presets for the agent.

Preset specific agents.<agent-type-name>.default.

Optional boolean which when set to true marks the preset as the default for selection.

Optional object for configuring Bridge SDK generation.

Optional TypeScript SDK configuration.

Optional list of agent type names, component names, or "*" for including all agents.

Optional custom output directory for the generated TypeScript SDK.

Optional Rust SDK configuration.

Optional list of agent type names, component names, or "*" for including all agents.

Optional custom output directory for the generated Rust SDK.

Optional map of secret defaults by environment name.

Optional list of secret default entries for the environment.

Required array of strings defining the path to the secret.

Required value of the secret default.

Optional map of retry policy defaults by environment name. Policies defined here are created in the environment during deployment if they don’t already exist.

Optional list of retry policy default entries for the environment.

Required unique name for this retry policy.

Required integer defining selection priority — higher values are evaluated first.

Required predicate tree defining when this policy applies. Supports composable predicates including property comparisons (propEq, propNeq, propGt, propGte, propLt, propLte), property checks (propExists, propIn, propMatches, propStartsWith, propContains), and logical combinators (and, or, not).

Required retry policy tree defining the retry strategy. Supports base strategies ("immediate", "never", periodic, exponential, fibonacci) and composable modifiers (countBox, timeBox, clamp, addDelay, jitter, filteredOn, andThen, union, intersect).

Optional map of quota resource defaults by environment name.

Optional list of resource definition entries for the environment.

Required name of the resource.

Required resource limit definition. Can be one of:

• Rate limit: {"type": "Rate", "value": <int>, "period": <timePeriod>, "max": <int>}
• Capacity limit: {"type": "Capacity", "value": <int>}
• Concurrency limit: {"type": "Concurrency", "value": <int>}

Where timePeriod is one of: second, minute, hour, day, month, year.

Required enforcement action for the resource, accepted values:

• reject

  available since1.1.0
• throttle

  available since1.1.0
• terminate

  available since1.1.0

Required string for the single unit of measurement (e.g., token, request).

Required string for the plural units of measurement (e.g., tokens, requests).