Recipe

n8n

The n8n automation platform for local development via Docker Compose, synthesized from the Workload kind by the compose provider. The data directory is a named volume, the only home of the workflows and the credentials authored in the editor, which survive a restart; state written anywhere else in the container does not. A workflow definition, when supplied on `values.flow_definition`, is carried in a compose config and imported by an init service with `n8n import:workflow` before the platform starts, on every start, so it is applied again rather than seeded once; with none, neither is rendered. The model wired into the `model` socket arrives as OPENAI_BASE_URL and its key as OPENAI_API_KEY. Each tool and vector store arrives under the variables helm/n8n names, AGGREGA_TOOL_<ALIAS>_URL, AGGREGA_VECTOR_STORE_<ALIAS>_URL, their parts and credentials, each credential written into the file as it was delivered. A connection writing an `inject:` block receives the names it dictates as on helm/n8n, a file as a compose config mounted at the path it names. N8N_BLOCK_ENV_ACCESS_IN_NODE is true unless the component's allow_env_access_in_nodes value is true, so a workflow reads these values through $env only then. `infra.external_base_url`, where set, becomes the editor address and the webhook base. With `values.metrics_enabled` true, N8N_METRICS turns n8n's metrics on, at /metrics on `infra.port`, which answers that path without a sign-in and which any peer on the compose network reaches, and provides.metrics_endpoint publishes the address; false, that key is empty. With `infra.published_port` set, the editor is published on that port of the host's loopback address, 127.0.0.1, alone.

Version

1.0.01.1.0

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:55a9b7dc759c8b5bf1d1a8fab03b75a8bad99c97a0898e276f0f97f543ef5435
Published
2026-11-15T08:09:26Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:769a0997237031d9044702a78bb6422d207cecc8ba6c2a05289a3c1fa5023399

Reference at this version

oci://hub.aggrega.ai/recipe/compose/n8n:1.1.0
Target
—
Implements
core/ai-agent/n8n:1.1.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
metrics_endpoint{{ if .values.metrics_enabled }}http://{{ .context.instance_id }}:{{ .locals.listen_port }}/metrics{{ end }}

Workload

Workload · form: stateless · containers: main

Locals

NameTemplate
listen_port{{ optional .infra "port" 5678 }}

Values mapping

No values mapping declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

  • implementsimplementscontract compatible

    core/ai-agent/n8n:1.1.0

    All required outputs are satisfied and every provided output is named in the contract.

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy