SMB

[joshtrichards]

Documentation

There are inconsistencies between the SMB and FULL examples examples:

• https://github.com/nextcloud/docker/tree/master/.examples/dockerfiles/smb
• https://github.com/nextcloud/docker/tree/master/.examples/dockerfiles/full

The former appears to be out-dated while the latter appears to better match the PHP image's recommended approach.

Some problems have been reported by others trying to use the SMB examples - e.g.

• [Bug]: SMB webdav Exception "Malformed state response from server", "Undefined index: attributes" server#41114 (comment) (this Issue isn't specific to the Docker image, but some of the comments in it highlight challenges noted by users trying to utilize the examples from here)
• smb support unavailable even from "full" image #1638
• Malformed state response from server icewind1991/SMB#109 (comment)

Tasks (preliminary):

• Review PHP image's recommended approach for adding things
• Assess whether our FULL example follows the PHP image model and otherwise seems reasonable
• Confirm native rather than wrapped SMB mode is detected/used by External Storage
• Test FULL example against a "typical" SMB server
• Port tested FULL example to SMB only example

Out of scope but worth mentioning:

• Upstream docs in this area could probably use some clarity (and I don't mean specific to Docker)

Image

Worth a revisit of whether to include/why we're not including smbclient in the image by default

Context:

• Community snap does not contain smbclient even though requested for years
• Community snap recommends using SMB/CIFS FUSE + Local mount
• SMB/CIFS FUSE is another option (possibly even preferred)
• Official Nextcloud GmbH AIO does contain smbclient

Tasks

• ... TBD
• If not including, document why as a FAQ/Known Issue in the README

[joshtrichards]

We also might want to explore documenting some other ways of mounting CIFS/SMB volumes since people don't seem to be aware of them:

• fstab (OS)
• docker volumes with the cifs driver (OS+docker)
• etc

Though at some point this is outside the scope of the image and more a pure documentation issue - and it's not realistic for us to document all third-party integrations. But maybe some hints + links to third-party docs

[juan11perez]

Gents,
I used the first example and worked fine for me.
I'm moving away from AIO and it did have smb.