n8n-nodes-smb2
Version:
Transfer files via Samba (SMB2) with n8n
76 lines (54 loc) • 2.58 kB
Markdown
# n8n-nodes-smb2
This is an n8n community node that lets you interact with Samba/SMB2 file shares in your n8n workflows. It enables reading, writing, and managing files on SMB2-compatible network shares.
[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
- [Installation](#installation)
- [Operations](#operations)
- [Credentials](#credentials)
- [Compatibility](#compatibility)
- [Resources](#resources)
## Installation
Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
## Operations
The node supports the following operations:
### Download
Downloads a file from the SMB share.
- **Path**: Full path to the file on the share (e.g., `/public/documents/file.txt`)
- **Put Output File in Field**: Name of the binary property to store the file data (default: `data`)
### Upload
Uploads a file to the SMB share.
- **Path**: Destination path on the share where the file will be saved
### List
Lists the contents of a directory on the SMB share.
- **Path**: Directory path to list (e.g., `/public/folder`)
### Delete
Deletes a file or folder from the SMB share.
- **Path**: Path to the file or folder to delete
### Rename/Move
Renames or moves a file or folder on the SMB share.
- **Old Path**: Current path of the file/folder
- **New Path**: New path/name for the file/folder
## Credentials
You need the following credentials to connect to an SMB share:
- **Host**: The hostname or IP address of the SMB server
- **Share Name**: The name of the share to connect to
- **Username**: Username for authentication
- **Password**: Password for authentication
- **Domain**: (Optional) Domain name for Active Directory authentication
## Compatibility
- Requires n8n version 1.0.0 or later
- Node.js v18.10 or later
- Compatible with SMB2/SMB3 protocol
## Resources
* [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
* [SMB2 Protocol Documentation](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-smb2/5606ad47-5ee0-437a-817e-70c366052962)
* [Samba Documentation](https://www.samba.org/samba/docs/)
## Error Handling
The node provides detailed error messages for common SMB issues:
- Access denied errors
- Network connectivity issues
- File/path not found
- Share not found
- Authentication failures
- Quota issues
- File sharing violations