nextcloud
SMB
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
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
Gents, I used the first example and worked fine for me. I'm moving away from AIO and it did have smb.
@LevAnni777 What bug are you referring to? The full example is valid / functions just fine.
Truenas: TrueNAS SCALE Dragonfish Nextcloud App: 29.0.3
Nextcloud runs without any errors.
When External SMB Storage is mounted in Nextcloud, the user experiences whole range of weird behaviors like:
Unable to list folder contents, Unable to upload certain files, or more than few files at once, Unable to download some files
Etc..
Meanwhile the nextcloud.log file generates these errors:
{"reqId":"7G6f9KKlCrUv8OAtpOOw","level":3,"time":"2024-07-20T14:47:10+00:00","remoteAddr":"192.168.2.235","user":"maka","app":"PHP","method":"PROPFIND","url":"/remote.php/dav/files/maka/Home/All%20Pics/","message":"Undefined array key \"attributes\" at /var/www/html/app> {"reqId":"7G6f9KKlCrUv8OAtpOOw","level":3,"time":"2024-07-20T14:47:10+00:00","remoteAddr":"192.168.2.235","user":"maka","app":"webdav","method":"PROPFIND","url":"/remote.php/dav/files/maka/Home/All%20Pics/","message":"Malformed state response from server","userAgent":"M>
Seems like there is no other way to either wait for docker publisher to update the smbclient package, or users like me are forced to build their own nextcloud docker container composed with a newer smbclient package :/ which involves far more knowledge than I have :/