AI agents: use the documentation index at llms.txt to locate machine-readable pages. This section is indexed by https://docs.particular.net/nservicebus/llms.txt. The markdown version of this page is served as plain text. An MCP server at /mcp serves the same content via the search_docs and read_doc tools; it is read-only and needs no credentials. Markdown versions of documentation pages are available by appending .md to the page URL. Directory URLs use index.md. They are served as text/plain because some retrieval backends reject text/markdown.

Gateway Upgrade Version 2 to 3

Component: Gateway

This is part of the NServiceBus Upgrade Guide from Version 6 to 7, which also includes the following individual upgrade guides for specific components:

Transports
Persistence
Hosting
Other

Code-first API

The gateway now allows full configuration via code. To enable the gateway and configure sites and channels:

endpointConfiguration.Gateway(new InMemoryDeduplicationConfiguration());

The above code replaces the previous method of configuring the gateway so the following should no longer be used:

endpointConfiguration.EnableFeature<Gateway>();

Configuration

When running on .NET Core, options in configuration files are not automatically detected. Use the code-first API instead.

When running on the .NET Framework, settings in configuration files will still be used. However a warning will be logged indicating that it should be explicitly configured using the code-first API instead.

Related Articles

In this article