Skip to main content

Learning Transport

The Learning Transport is a simple file-based transport used mainly for local development and tutorials.

Configuration​

To use the Learning Transport, define it under transports and reference it as current-transport.

Example​

current-transport: local-learning

transports:
- name: local-learning
learning-transport-config:
storage-directory: C:\Source\tutorials-quickstart\.learningtransport
restrict-payload-size: true

learning-transport-config Fields​

FieldRequiredTypeDefaultDescription
storage-directoryYesstring—Absolute path where Learning Transport stores message files.
restrict-payload-sizeNobooleantrueEnforces the NServiceBus payload size limit. Set to false if you need to send larger payloads.

Field Details​

storage-directory (required)​

This must be an absolute file path. The Learning Transport stores outgoing and incoming messages in a folder structure at this location. If this value is missing, Busly reports an error and exits.

Example:

storage-directory: C:\MyProject\.learningtransport

restrict-payload-size (optional, default: true)​

When enabled (the default), Busly enforces the same message size limits as NServiceBus.

Set to false if using large JSON payloads or test messages.

Example:

restrict-payload-size: false