> For the complete documentation index, see [llms.txt](https://docs.frends.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.frends.com/release-notes/frends-6.4/version-6.4.0.md).

# Version 6.4.0

Released on 10th of November 2026

This release introduces the [Visual Data Mapper](https://docs.frends.com/release-notes/frends-6.4/new-features.md#visual-data-mapper) for building data transformations visually, and [Certificate Management](https://docs.frends.com/release-notes/frends-6.4/new-features.md#certificate-management) for delivering certificates to Agents and ordering them automatically from an ACME certificate authority. Frends 6.4 no longer supports the [Legacy Agent](https://docs.frends.com/release-notes/frends-6.4/new-features.md#legacy-agent-removed).

This release also includes the improvements and bug fixes released in [version 6.3.3](https://docs.frends.com/release-notes/frends-6.3/version-6.3.3.md) and the earlier 6.3 releases.

{% hint style="info" %}
On-premises Cross-Platform Agents require .NET Runtime 10.0.7 or newer to be installed.

The Windows Agent and Management Web Portal require the .NET 10 hosting bundle to be installed.

Cloud Agents and Compliant Cloud images include .NET 10 out of the box.
{% endhint %}

{% hint style="warning" %}
Remember to check the [Breaking Changes](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md) for this version of Frends before updating.
{% endhint %}

{% hint style="warning" %}
Updating requires running the database initializer; see [Database schema update](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md).
{% endhint %}

## Process and Subprocess <a href="#process-and-subprocess" id="process-and-subprocess"></a>

### Improvements <a href="#improvements" id="improvements"></a>

* The new Visual Data Mapper shape maps data between a source and a target schema by drawing connections; see [New Features](https://docs.frends.com/release-notes/frends-6.4/new-features.md).
* Text-mode parameters now support conditionals (`{{#if}}`) and loops (`{{#each}}`); see [New Features](https://docs.frends.com/release-notes/frends-6.4/new-features.md). (Requires rebuilding the Process)
* Processes, Triggers and Process Variables can refer to a managed certificate with `#cert.<name>.<property>`; see [New Features](https://docs.frends.com/release-notes/frends-6.4/new-features.md).
* Every shape now logs its parameters at the default log level truncated instead of being omitted, so a run can be followed step by step without switching the Process to Debug; see [Shape parameters in Process logs](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes. (Requires rebuilding the Process)
* Processes are now compiled for .NET 10 only; the .NET Framework 4.7.1 and .NET Standard 2.0 targets have been removed; see [Legacy Agent removed](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes.
* Improved validation for Schedule Triggers, saving a Process now rejects a daily or weekly Schedule Trigger with an empty recurrence, or a weekly one with no day selected, instead of the Trigger failing on the Agent when it is activated; see [Schedule Trigger validation](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes.

### Bug fixes <a href="#bug-fixes" id="bug-fixes"></a>

* Fixed Checkpoint validation rejecting a branch that ends in a Return.
* Fixed a Code shape whose code ends with a line comment failing to compile. (Requires rebuilding the Process)
* Fixed an HTTP Response shape failing to compile when its headers use text-mode values. (Requires rebuilding the Process)
* Fixed a Queue Trigger ignoring the reply-to queue of a request and dropping the reply when no default reply queue is set.
* Fixed a Schedule Trigger failing on the Agent when a day selection was left empty.
* Fixed exporting and importing a Process as BPMN changing some shape types, such as a Code shape into an Expression shape.
* Fixed discarding a draft leaving the Process in the Draft state in the Process list.
* Fixed a Process created or imported by a user with Allow tag rules being saved without its tags when the save failed partway.
* Fixed importing a Task not adding the dependencies that Agents on a newer .NET version need to the NuGet feed.

## API Management and API Policies <a href="#api-management-and-api-policies" id="api-management-and-api-policies"></a>

### Improvements <a href="#improvements" id="improvements"></a>

* Deploying an API to an Agent Group is now rejected when another API deployed there still links one of its Processes, instead of breaking the other API when the old one is deleted; see [API deployment with linked Processes](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes.

### Bug fixes <a href="#bug-fixes" id="bug-fixes"></a>

* Fixed importing some API specification files failing with an internal server error.
* Fixed the paging links of the Platform API Process deployment list dropping the tag and Subprocess filters.

## Agent <a href="#agent" id="agent"></a>

### Improvements <a href="#improvements" id="improvements"></a>

* Certificates managed in Frends are installed on the Agents automatically, and an Agent can serve several HTTPS certificates chosen by host name; see [New Features](https://docs.frends.com/release-notes/frends-6.4/new-features.md). Certificates are delivered only to Agents running Frends 6.4 or newer; see [Agent version for certificates](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes.
* The Agent now honours `X-Forwarded-Host` and `X-Forwarded-Proto` headers only from trusted proxies when it builds the URLs it returns for OpenAPI documents and the MCP Trigger endpoint. See [Forwarded headers on the Agent](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes.
* The Agent now picks up issuer certificates added to or removed from its client certificate issuer store without a restart, and caches client certificate validation results.
* Each Agent Group's RabbitMQ user can now read only its own Agent Group's queues.
* Logging of unauthenticated and unmatched HTTP requests to the Agent is now limited per minute, and the rest are summarised, so a scan or a misbehaving client no longer floods the HTTP log. See [HTTP log of unauthenticated and unmatched requests](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes.

### Bug fixes <a href="#bug-fixes" id="bug-fixes"></a>

* Fixed the Windows Agent installer failing in its .NET version check. The installer now checks for the .NET Runtime and ASP.NET Core Runtime before installing.

## Frends MCP <a href="#frends-mcp" id="frends-mcp"></a>

### Improvements <a href="#improvements" id="improvements"></a>

* The Process builder tools now support the Visual Data Mapper shape, including setting its source schema.
* Process builder requests with invalid input are now rejected with readable validation errors.

### Bug fixes <a href="#bug-fixes" id="bug-fixes"></a>

* Fixed edits through Frends MCP removing the colours of shapes, connections and labels.
* Fixed edits through Frends MCP removing the arrows of text annotation.
* Fixed Frends MCP requiring a parent scope for connections inside a scope.

## UI and Web Portal <a href="#ui-and-web-portal" id="ui-and-web-portal"></a>

### Improvements <a href="#improvements" id="improvements"></a>

* Process editor validation errors are now shown in a collapsible list on the canvas, grouped by shape, instead of in notifications.
* Compilation errors are now shown under the shape that caused them.
* The expression editor validates the syntax of parameters as you type, offers IntelliSense based on the schemas of Process Variables and shape results, and has improved syntax highlighting.

### Bug fixes <a href="#bug-fixes" id="bug-fixes"></a>

* Fixed autocomplete suggestions intermittently not appearing in expression fields.
* Fixed the Process documentation being lost when it was edited before a new Process was saved.
* Fixed Environment Variable search failing for some search terms.
* Fixed rows of Task array parameters and Manual Trigger parameters stretching or shifting while being dragged.

## Security and Authentication <a href="#security-and-authentication" id="security-and-authentication"></a>

### Improvements <a href="#improvements" id="improvements"></a>

* Values of secret Environment Variables, secret Process Variables and secret Manual Trigger parameters are now masked in Process logs; see [Masked values in Process logs](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes. (Requires rebuilding the Process)
* Credential headers, cookies and query parameters of HTTP and API Trigger requests are now masked in Process logs. By default the masked names are `Authorization`, `Cookie`, `X-Api-Key`, `X-ApiKey`, `X-Auth-Token` and `Proxy-Authorization`, plus the API key name of the API Policy, and they can be changed with the Agent setting `TriggerHeadersToMask`; see [Masked values in Process logs](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes. (Requires rebuilding the Process)
* Certificate private keys and ACME account keys can be encrypted at rest in the Frends database; see [Certificate and ACME key protection](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes.

### Bug fixes <a href="#bug-fixes" id="bug-fixes"></a>

* Fixed a user restricted by Environment rules being able to receive real-time Process and Agent status updates for Agent Groups in Environments they cannot access.
* Fixed passwords containing quotes failing the database initializer script and appearing in its error output.
* Fixed setting only `IpAddress` in a `PlatformJwtAllowedIps` entry admitting every IPv4 caller, because the entry inherited the shipped subnet mask `0.0.0.0`.

## Log Service and Observability <a href="#log-service-and-observability" id="log-service-and-observability"></a>

### Improvements <a href="#improvements" id="improvements"></a>

* Process step data is now always logged to blob storage; the option to log steps to the database has been removed; see [Step logging to the database removed](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes.
* A Process that fails before any of its steps run now logs the failed Trigger step to blob storage like other steps.
* Logging large step values is now lighter, because values are cut to the logging limits while they are serialized instead of afterwards. (Requires rebuilding the Process)

### Bug fixes <a href="#bug-fixes" id="bug-fixes"></a>

* Fixed a step whose result throws an exception while it is being logged, such as a lazily evaluated query, showing as started but never finished. The step is now logged as finished with the serialization error as its result. (Requires rebuilding the Process)
* Fixed the Process instance view showing no step data when a logged value contains a key named `constructor` or `__proto__`.

## Infrastructure, Build, and Dependencies <a href="#infrastructure-build-and-dependencies" id="infrastructure-build-and-dependencies"></a>

### Improvements <a href="#improvements" id="improvements"></a>

* log4net has been removed. The Log Service writes its log file through the standard .NET `Logging` configuration in its `appsettings.json`, and the database initializer logs to the console. See [Log Service and database initializer logging](https://docs.frends.com/release-notes/frends-6.4/breaking-changes.md#breaking-changes-in-version-640) in the breaking changes.
* The database initializer can now set up PostgreSQL with less required privileges
* The Shared State store now handles transient database errors under concurrent access.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.frends.com/release-notes/frends-6.4/version-6.4.0.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
