{"id":34903134,"url":"https://github.com/jimmymtl/n8n-nodes-smbclient","last_synced_at":"2026-05-03T21:02:06.460Z","repository":{"id":321285128,"uuid":"1085222917","full_name":"JimmyMtl/n8n-nodes-smbclient","owner":"JimmyMtl","description":"Interact with smb protocol using smbclient on self-hosted n8n instances.","archived":false,"fork":false,"pushed_at":"2026-05-03T19:28:11.000Z","size":213,"stargazers_count":3,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-03T20:37:47.828Z","etag":null,"topics":["n8n","n8n-community-node-package","n8n-nodes","samba","samba-client","smb","smbclient"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/n8n-nodes-smbclient","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JimmyMtl.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-28T18:41:30.000Z","updated_at":"2026-05-03T19:27:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"273bad1e-3744-47b8-a4d2-77bb83fec251","html_url":"https://github.com/JimmyMtl/n8n-nodes-smbclient","commit_stats":null,"previous_names":["jimmymtl/n8n-nodes-smbclient"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/JimmyMtl/n8n-nodes-smbclient","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimmyMtl%2Fn8n-nodes-smbclient","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimmyMtl%2Fn8n-nodes-smbclient/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimmyMtl%2Fn8n-nodes-smbclient/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimmyMtl%2Fn8n-nodes-smbclient/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JimmyMtl","download_url":"https://codeload.github.com/JimmyMtl/n8n-nodes-smbclient/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JimmyMtl%2Fn8n-nodes-smbclient/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32584651,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["n8n","n8n-community-node-package","n8n-nodes","samba","samba-client","smb","smbclient"],"created_at":"2025-12-26T09:08:12.556Z","updated_at":"2026-05-03T21:02:06.446Z","avatar_url":"https://github.com/JimmyMtl.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# n8n-nodes-smbclient\n\nThis is a n8n community node that lets you interact with Samba/SMB2 file shares in your n8n workflows using\nsamba-client linux package. It enables\nreading, writing, and managing files on SMB2-compatible network shares.\n\n[N8N](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.\n\n- [Installation](#installation)\n- [Operations](#operations)\n- [Credentials](#credentials)\n- [Compatibility](#compatibility)\n- [Resources](#resources)\n\n## Installation\n\nFollow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community\nnodes documentation.\n\n\u003e Be sure to have the samba-client package installed in your n8n instance/container.\n\u003e For example, in a Dockerfile based on n8n image, you can add:\n\u003e ```Dockerfile\n\u003e RUN apk add --no-cache samba-client\n\u003e ```\n\u003e This ensures that the samba-client is installed before n8n starts.\n\u003e\n\u003e Without this package, the SMB node will not function correctly.\n\u003e\n\u003e Make sure to rebuild your Docker image or restart your container after making these changes.\n\u003e You can verify the installation by running `smbclient --version` inside your n8n container.\n\u003e\n\u003e If the command returns the version of samba-client, the installation was successful.\n\u003e\n\u003e If you encounter any issues, refer to the samba-client documentation or seek help from the n8n community forums.\n\u003e\n\u003e Remember to keep your samba-client package updated to ensure compatibility and security.\n\u003e\n\u003e For Alpine-based images, use `apk add --no-cache samba-client`.\n\u003e\n\u003e For Debian/Ubuntu-based images, use `apt-get update \u0026\u0026 apt-get install -y smbclient`.\n\u003e\n\u003e For CentOS-based images, use `yum install -y samba-client`.\n\u003e\n\u003e Adjust the package manager commands based on your specific Linux distribution used in your n8n instance.\n\u003e\n\u003e Ensure that the samba-client version is compatible with your SMB server version to avoid connectivity issues.\n\n## Operations\n\nThe node supports the following operations:\n\n- Download a file from the SMB share.\n\n- Upload a file to the SMB share.\n\n- List the contents of a directory on the SMB share.\n\n- Delete a file or folder from the SMB share.\n\n- Rename or moves a file or folder on the SMB share.\n\n## Credentials\n\nYou need the following credentials to connect to an SMB share:\n\n- **Host**: The hostname or IP address of the SMB server\n- **Share Name**: The name of the share to connect to\n- **Username**: Username for authentication\n- **Password**: Password for authentication\n- **Domain**: (Optional) Domain name for Active Directory authentication\n\n## Compatibility\n\n- /!\\ **Requires** samba-client apk package installed on image /!\\\n- **Requires** n8n version 1.0.0 or later\n- Node.js v18.10 or later\n- Compatible with SMB2/SMB3 protocol\n\n## Resources\n\n* [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)\n* [SMB2 Protocol Documentation](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-smb/5606ad47-5ee0-437a-817e-70c366052962)\n* [Samba Documentation](https://www.samba.org/samba/docs/)\n\n## Error Handling\n\nThe node provides detailed error messages for common SMB issues:\n\n- Access denied errors\n- Network connectivity issues\n- File/path not found\n- Share not found\n- Authentication failures\n- Quota issues\n- File sharing violations\n\n## Running local (Development)\n\n\u003e Required podman and n8nio image setup\n\n1. Run build\n2. Launch a terminal to your podman container\n3. Go to nodes folder\n\n```shell\ncd ~/.n8n/nodes\n```\n\n4. Update package.json in `~/.n8n/nodes` using `vim` and put the following line\n\n```json\n{\n\t\"name\": \"installed-nodes\",\n\t\"private\": true,\n\t\"dependencies\": {\n\t\t\"n8n-nodes-smbclient\": \"file:/opt/code-temp\"\n\t}\n}\n```\n\n\u003e **Warning:** be sure to mount a volumes in your image, example with a docker-compose :\n\u003e  ```yaml\n\u003e services:\n\u003e\t  n8n:\n\u003e\t  image: n8nio/n8n:1.118.0\n\u003e\t    ports:\n\u003e\t      - \"5678:5678\"\n\u003e\t    volumes:\n\u003e\t     - C:\\_wksp\\my-folder\\n8n-nodes-smbclient:/opt/code-temp\n\n6. Restart your pod and voilà\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjimmymtl%2Fn8n-nodes-smbclient","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjimmymtl%2Fn8n-nodes-smbclient","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjimmymtl%2Fn8n-nodes-smbclient/lists"}