Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cdzombak/samba-docker
Up-to-date Samba Docker image optimized for NAS file sharing with full macOS Spotlight support.
https://github.com/cdzombak/samba-docker
docker elasticsearch nas samba samba-server selfhosted spotlight
Last synced: about 1 month ago
JSON representation
Up-to-date Samba Docker image optimized for NAS file sharing with full macOS Spotlight support.
- Host: GitHub
- URL: https://github.com/cdzombak/samba-docker
- Owner: cdzombak
- License: gpl-3.0
- Created: 2023-12-28T20:35:43.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-05-31T20:45:26.000Z (7 months ago)
- Last Synced: 2024-06-01T20:39:58.582Z (7 months ago)
- Topics: docker, elasticsearch, nas, samba, samba-server, selfhosted, spotlight
- Language: Dockerfile
- Homepage:
- Size: 31.3 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# samba-docker
Up-to-date Samba Docker image optimized for NAS file sharing with full macOS Spotlight support via Elasticsearch integration.
## Configuration & Usage
TK
### Using `testparm`
With your `docker-compose.yml` set up, you can use [`testparm`](https://www.samba.org/samba/docs/current/man-html/testparm.1.html) as follows to check your `smb.conf`:
```shell
docker compose run samba testparm /usr/local/samba/etc/smb.conf
```
### IO and Nice Prioritization
Samba is arguably the most important thing running on my NAS; when I'm browsing files/folders on it, I want it to be _as fast as possible_. To help achieve this I've added the following to the `samba` service in my `docker-compose` file:
```
command:
- ionice
- -c1
- -n1
- nice
- -n-17
- /usr/local/samba/sbin/smbd
- --foreground
- --no-process-group
- --configfile
- /usr/local/samba/etc/smb.conf
cap_add:
- CAP_SYS_NICE
```
This runs `smbd` in the "realtime" IO class, with priority `1` (the possible priorities are `0-7`, with lower numbers being higher priority). To give it priority on the CPU, I also give `smbd` a `nice` value of `-17` (values range down to `-19`, the highest priority).
### Elasticsearch & FSCrawler (for Spotlight support)
TK
also TK: cpu shares for the ES stuff; and (io)nice values for the same.
## Monitoring with Netdata
TK
## Migrating away from system Samba
TK: necessary if you want samba container to use host networking and listen on 445
```
apt remove smbclient samba samba-common && apt autoremove
```
## See Also
TK: raindrop bookmarks
### Samba
TK: samba docs in general: smbd, conf, build, general wiki refs
- [`smb.conf` reference](https://www.samba.org/samba/docs/current/man-html/smb.conf.5.html)
- [`smbd` reference](https://www.samba.org/samba/docs/current/man-html/smbd.8.html)
- [`smbpasswd` reference](https://www.samba.org/samba/docs/current/man-html/smbpasswd.8.html)
- https://wiki.samba.org/index.php/Build_Samba_from_Source
- https://www.samba.org/samba/docs/current/man-html/vfs_fruit.8.html
- https://wiki.samba.org/index.php/Configure_Samba_to_Work_Better_with_Mac_OS_X
- https://wiki.samba.org/index.php/Configuring_Logging_on_a_Samba_Server
### Elasticsearch and Spotlight
n.b. Elasticsearch 8.9.0 and newer **are not compatible with Samba**.
TK: spotlight, es, indexers, samba bugs
- https://wiki.samba.org/index.php/Spotlight_with_Elasticsearch_Backend
- https://bugzilla.samba.org/show_bug.cgi?id=15511
- https://bugzilla.samba.org/show_bug.cgi?id=15342
- https://github.com/Ellerhold/fs2es-indexer/issues/27#issuecomment-1676052344
- https://lists.samba.org/archive/samba/2023-August/246274.html
- https://fscrawler.readthedocs.io/en/latest
## License
Original works in this repo are licensed under GPL3; see `LICENSE` in this repo.
## Author
[Chris Dzombak](https://www.dzombak.com) ([github.com/cdzombak](https://www.github.com/cdzombak))