SMB Connector

This node connects to a remote SMB server (e.g. Samba, or Windows Server). The resulting output port allows downstream nodes to access files, e.g. to read or write, or to perform other file system operations (browse/list files, copy, move, ...). This node generally supports versions 2 and 3 of the SMB protocol. It also supports connecting to a Windows DFS namespace.

Path syntax: Paths for SMB are specified similar to Windows Paths, but with a leading backslash (\). The path is interpreted relative to the chosen Share (or DFS namespace). For example \myfolder\file.csv, is an absolute path that consists of:

  1. A leading backslash (\).
  2. The name of a folder (myfolder), followed by a backslash.
  3. Followed by the name of a file (file.csv).

Options

Connect to
Specifies whether to connect by specifying a file server host or a Windows domain.
  • File server: Connect directly to a file share on a specific file server. A file server is any machine that runs an SMB service, such as Windows Server or Samba. For example, this is similar to connecting to \\server.company.com\marketing using Windows Explorer.
  • Domain: Connect to a file share in a Windows Active Directory domain. For example, this is similar to connecting to \\company.com\marketing using Windows Explorer, which first locates and then connects to an SMB service that provides the file share or DFS namespace for the domain.
Host
Hostname of the server where the SMB service runs, e.g. server.company.com.
Port
Port that the SMB server is listening on for incoming connections.
Share
The name of the file share provided by the SMB server. The name must not contain any backslashes.
Domain
The name of the Windows domain (Active Directory), e.g. company.com.
Share/Namespace
The name of the file share or DFS namespace to access. The name must not contain any backslashes.
SMB version(s)
Allows to enforce the usage of specific SMB protocol version(s). Selecting "Auto" will make the node choose the highest version supported by both this node and the SMB server.
  • Auto: Automatically choose the highest version supported by both parties.
  • 2.0.2: Use SMB version 2.0.2.
  • 2.1: Use SMB version 2.1.
  • 2.x (2.1, 2.0.2): Use the highest 2.x version supported by both parties.
  • 3.0: Use SMB version 3.0.
  • 3.0.2: Use SMB version 3.0.2.
  • 3.1.1: Use SMB version 3.1.1.
  • 3.x (3.1.1, 3.0.2, 3.0): Use the highest 3.x version supported by both parties.
Use encryption
If enabled, the node will use SMB Encryption that provides SMB data end-to-end encryption, if also supported by the SMB server. This option requires SMB version 3.x.
Authentication method
Specify the authentication method to use.
  • Username & password: Authenticate with a username and password (NTLM). Values entered here will be stored (weakly encrypted) with the workflow. The username field also accepts usernames of the form DOMAIN\user and user@DOMAIN.
  • Kerberos: Authenticate using an existing Kerberos ticket.
  • Guest: Authenticate as the Guest user (without password).
  • Anonymous: Authenticate with an empty username (without password).
Username & Password
Credentials for username and password authentication.
Working directory
Specify the working directory of the resulting file system connection. The working directory must be specified as an absolute path starting with a backslash. A working directory allows downstream nodes to access files/folders using relative paths, i.e. paths that do not have a leading backslash. The default working directory is the root "\".
Read/Write timeout (seconds)
The timeout in seconds for read/write operations.

Input Ports

This node has no input ports

Output Ports

Icon
SMB File System Connection.

Popular Predecessors

Popular Successors

Views

This node has no views

Workflows

Links

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.

Installation

To use this node in KNIME, install the extension KNIME Basic File System Connectors from the below update site following our NodePit Product and Node Installation Guide:

v5.11

A zipped version of the software site can be downloaded here.

Plugin provider: KNIME AG, Zurich, Switzerland
Plugin version: 5.11.0.v202602121051
On NodePit since: 2026-03-10
Last update: 2026-03-23
Tags: StreamableModern UI
KNIME versions: Since v4.4

Deploy, schedule, execute, and monitor your KNIME workflows locally, in the cloud or on-premises – with our brand new NodePit Runner.

Try NodePit Runner!