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.

• https://github.com/nextcloud/server/issues/41114#issuecomment-1779285006 (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)
• https://github.com/nextcloud/docker/issues/1638
• https://github.com/icewind1991/SMB/issues/109#issuecomment-1249150031

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.