SMB/CIFS missing from list of protocols in rclone config

Problem

I am trying to add a remote for SMB/CIFS according to the documentation, but I am not seeing an option for it in the list of protocols after running rclone config.

Rclone version

rclone v1.59.1
- os/version: darwin 12.4 (64 bit)
- os/kernel: 21.5.0 (x86_64)
- os/type: darwin
- os/arch: amd64
- go/version: go1.18.5
- go/linking: dynamic
- go/tags: cmount

Output from Rclone config

Current remotes:

Name                 Type
====                 ====
drive                drive

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> n

Enter name for new remote.
name> remote

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
 1 / 1Fichier
   \ (fichier)
 2 / Akamai NetStorage
   \ (netstorage)
 3 / Alias for an existing remote
   \ (alias)
 4 / Amazon Drive
   \ (amazon cloud drive)
 5 / Amazon S3 Compliant Storage Providers including AWS, Alibaba, Ceph, China Mobile, Cloudflare, ArvanCloud, Digital Ocean, Dreamhost, Huawei OBS, IBM COS, IDrive e2, Lyve Cloud, Minio, Netease, RackCorp, Scaleway, SeaweedFS, StackPath, Storj, Tencent COS and Wasabi
   \ (s3)
 6 / Backblaze B2
   \ (b2)
 7 / Better checksums for other remotes
   \ (hasher)
 8 / Box
   \ (box)
 9 / Cache a remote
   \ (cache)
10 / Citrix Sharefile
   \ (sharefile)
11 / Combine several remotes into one
   \ (combine)
12 / Compress a remote
   \ (compress)
13 / Dropbox
   \ (dropbox)
14 / Encrypt/Decrypt a remote
   \ (crypt)
15 / Enterprise File Fabric
   \ (filefabric)
16 / FTP
   \ (ftp)
17 / Google Cloud Storage (this is not Google Drive)
   \ (google cloud storage)
18 / Google Drive
   \ (drive)
19 / Google Photos
   \ (google photos)
20 / HTTP
   \ (http)
21 / Hadoop distributed file system
   \ (hdfs)
22 / HiDrive
   \ (hidrive)
23 / Hubic
   \ (hubic)
24 / In memory object storage system.
   \ (memory)
25 / Internet Archive
   \ (internetarchive)
26 / Jottacloud
   \ (jottacloud)
27 / Koofr, Digi Storage and other Koofr-compatible storage providers
   \ (koofr)
28 / Local Disk
   \ (local)
29 / Mail.ru Cloud
   \ (mailru)
30 / Mega
   \ (mega)
31 / Microsoft Azure Blob Storage
   \ (azureblob)
32 / Microsoft OneDrive
   \ (onedrive)
33 / OpenDrive
   \ (opendrive)
34 / OpenStack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
   \ (swift)
35 / Pcloud
   \ (pcloud)
36 / Put.io
   \ (putio)
37 / QingCloud Object Storage
   \ (qingstor)
38 / SSH/SFTP
   \ (sftp)
39 / Sia Decentralized Cloud
   \ (sia)
40 / Storj Decentralized Cloud Storage
   \ (storj)
41 / Sugarsync
   \ (sugarsync)
42 / Transparently chunk/split large files
   \ (chunker)
43 / Union merges the contents of several upstream fs
   \ (union)
44 / Uptobox
   \ (uptobox)
45 / WebDAV
   \ (webdav)
46 / Yandex Disk
   \ (yandex)
47 / Zoho
   \ (zoho)
48 / premiumize.me
   \ (premiumizeme)
49 / seafile
   \ (seafile)
Storage> 

Additional notes

I see in the documentation the following note:

This relies on go-smb2 library for communication with SMB protocol.

Is this saying I need to fetch this library if I want to have the option of choosing SMB/CIFS as a backend? Or is this just a technical detail about how Rclone integrates with SMB/CIFS?

Update rlcone as your version does not have it.

hello and welcome to the forum,

smb remote requires 1.60.0
https://rclone.org/changelog/#v1-60-0-2022-10-21

try rclone selfupdate

1 Like

Wow, thanks for the quick reply!

I can confirm after running rclone selfupdate and verifying version 1.60.0 that I now see the option for SMB/CIFS.

If I could make a recommendation though: In the documentation for each feature, maybe there could be a note on the sidebar about the first release version? That way people can see which version they need to be on to use a feature?

Of course, if people are following the release schedule and updating frequently, maybe this is a moot point.

That's very tough to maintain and would be documentation hell imo.

We do ask for checking the versions as part of the template so I wonder if there is better wording?

Do not type in "Latest".
Do not just type in a version number. Run the command and share the full output.

Are you on the latest version of rclone? You can validate by checking the version listed here: https://rclone.org/downloads/

Did you end up checking that or would have some better wording maybe?

sure

yeah, what @Animosity022 wrote

@Animosity022 Thanks for explaining. I understand why you might not want to take that on.

I am new to the Rclone project and did not realize how quickly it changes. So admittedly, I assumed I was on the latest version since I just installed it a couple months ago. But I see now that a minor and major revision were made in that time.

I think your explanation in the template is good enough, I just need to read a little more carefully next time.

If we did do it I'd probably limit it to a release version for backends only. That sounds manageable. Could possibly add commands.

Hmm. So maybe like a minimum version introduced like 1.60+ or something along those lines?

Yes. I was thinking about adding something to the header of each of the backend pages which showed the version or rclone that the backend was introduced.

It would be easy to get the templates to render that somewhere so all backend authors would have to do is set the version flag. Maybe I'd call it versionIntroduced.

---
title: "Google drive"
description: "Rclone docs for Google drive"
version: 1.32
---

Is it worth doing?

How do you think the versionIntroduced should show on the page? Maybe as a grey box floating next to the title?

I'm generally the optimist and I'd hope people would read the docs so I tend to lean that way. If the effort is minimal, I think it would be helpful.

I think that's fine. I always rather do something and changes can be made based on feedback. I am not great at that type of design...

Sounds like there's a consensus, but for the record, this is what I was thinking: Just a "version introduced" for each backend. Definitely not advocating for bumping version on documents for 50+ backends every time there's a minor upgrade.

How does this look?

There is a tooltip over the badge which says This feature requires Rclone v1.58.0

I've added (with a 10 line bash script!) the release tag for all the backends.

This could go on any page just by adding versionIntroduced: "v1.20" in the frontmatter at the top of the page.

2 Likes

I merged that fix! You'll see it on https://tip.rclone.org/ tomorrow when it updates and on the main website at the next release v1.61

I like it :+1:

...to such a degree that I suggest to immediately extend it to also indicate any experimental status :face_with_open_eyes_and_hand_over_mouth:

Here:

hi,
that looks good, but for a newbie, might be too cryptic.

v1.50.0 is just a version number, but no indication what it is for.

so something like this

Status: Experimental - Minimum Version Required: v1.50.0

Did you mean like this:

I see your point, but I think it will probably look a bit verbose - at least on a small phone screen it might not look so good. There is extended description in tooltips, e.g. "This feature needs Rclone v1.60.0 or later.", but then again - on a phone/touch device tooltips are usually not that accessible... :thinking:

good points,

perhaps
--- use smaller font, same as used for body text

Experimental : Minimum Version=v1.60.0

and if backend is stable, most common case, no need for specify status.

Minimum Version=v1.60.0

I think they are too verbose like that. I think just Experimental and v1.60.0 is fine. If we wanted to make them accessible on a phone then we could make clicking on them produce the tooltip. I'm sure there is a bootstrap thingy for that!

This topic was automatically closed 3 days after the last reply. New replies are no longer allowed.