crazy-max/docker-samba is one of the developer-focused repositories TopGit tracks, currently at 635 stars, written primarily in Dockerfile. Samba Docker image
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Before using this image you have to create the YAML configuration file
/data/config.yml to be able to create users, provide global options and add
shares. Here is an example:
recycle: yes enables the vfs_recycle module. Any other value, including
no, leaves recycle disabled.
The vfs_recycle intercepts file deletion requests and moves the affected
files to a temporary repository rather than deleting them immediately. This
gives the same effect as the Recycle Bin on Windows computers. On this image it
is stacked with the default fruit and streams_xattr VFS modules so macOS
shares keep a consistent VFS configuration.
options is a list of raw Samba share parameters appended to the generated
share section. Use it for share-specific settings that are not modeled as
first-class YAML keys:
share:
- name: media
path: /samba/media
readonly: no
guestok: yes
options:
- "create mask = 0664"
- "directory mask = 0775"
- "force user = media"
- "force group = media"
- "store dos attributes = yes"
These options are written after the generated share settings, so they can also
override generated defaults when needed.
Docker compose is the recommended way to run this image. Copy the content of folder examples/compose
in /var/samba/ on your host for example. Edit the compose and configuration files with your preferences and run the
following commands:
If you want to deploy this Container in your Kubernetes Cluster you can you this Helm Chart: https://github.com/tzabbi/crazy-max-samba-helm
Upgrade
Recreate the container whenever I push an update:
docker compose pull
docker compose up -d
Notes
Variable interpolation
Values in a YAML file can be set by variables, and interpolated at runtime using
a Bash-like syntax ${VARIABLE}.
Default values can be defined inline using typical shell syntax ${VARIABLE-default}.
It evaluates to default only if VARIABLE is unset in the environment.
Here is an example:
auth:
- user: foo
group: foo
uid: 1000
gid: 1000
password: bar
share:
- name: foo
path: /samba/foo
browsable: ${BROWSABLE-no}
readonly: no
guestok: no
validusers: foo
writelist: foo
Zeroconf service discovery for Linux and macOS clients can be enabled by
setting AVAHI_ENABLE to 1. It publishes the _smb._tcp service on port
445 and a _device-info._tcp record for Finder using Avahi.
If you use Samba as a Time Machine target, set AVAHI_ADISK_NAME to the
matching share name to publish an _adisk._tcp record. No _adisk._tcp record
is published by default because advertising a non-existent Time Machine share
breaks client expectations.
mDNS uses multicast UDP port 5353, so the container must use host networking
on a Linux host. Docker Desktop host networking on macOS and Windows does not
provide LAN-visible multicast discovery for this use case.
The advertised service name follows the Avahi hostname by default. Set
AVAHI_NAME to control the name shown by service browsers such as Finder
without changing the host address record.
Set AVAHI_HOSTNAME to control the .local host name used by Avahi. Do not
include the .local suffix. This changes the host address record, so prefer
AVAHI_NAME when you only need a friendlier service name. If another mDNS stack
is already running on the host network, competing host address records can cause
Avahi host name conflicts.
Avahi listens on every interface by default. Set AVAHI_INTERFACES, for
example eth0, to avoid advertising on Docker bridge, loopback, or veth
interfaces.
See examples/zeroconf as an example.
Service discovery for Windows
Service discovery for Windows can be enabled by setting WSDD2_ENABLE to 1.
You also need to set the following capabilities to the container:
CAP_NET_ADMIN
CAP_NET_RAW
Name will be the hostname of the host if network mode is host or one of
the container. If you want to override this value, you can set hostname in
your compose file or set WSDD2_HOSTNAME env var.
NetBIOS name will be the hostname of the host. If you want to override this
value, you can set WSDD2_NETBIOS_NAME env var.
See examples/windows as an example.
Contributing
Want to contribute? Awesome! The most basic way to show your support is to star
the project, or to raise issues. You can also support this project by becoming a sponsor on GitHub
or by making a PayPal donation to ensure this
journey continues indefinitely!
Thanks again for your support, it is much appreciated! :pray:
Does crazy-max/docker-samba have a project website?
No homepage URL was recorded for crazy-max/docker-samba in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How does crazy-max/docker-samba compare to other Developer Tools projects?
crazy-max/docker-samba is tracked by TopGit in the Developer Tools category, with 635 GitHub stars and written in Dockerfile. Browse the Developer Tools topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does crazy-max/docker-samba have?
crazy-max/docker-samba has 635 GitHub stars — refresh the page for the live number, or check github.com/crazy-max/docker-samba. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is crazy-max/docker-samba open source?
Yes — crazy-max/docker-samba ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/crazy-max/docker-samba.
What else is in the Developer Tools space?
crazy-max/docker-samba is tracked by TopGit under the Developer Tools category, alongside 5 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is crazy-max/docker-samba?
crazy-max/docker-samba (crazy-max/docker-samba) is a Dockerfile project on GitHub. From the project's own README: Samba Docker image
Where do I read more about crazy-max/docker-samba?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/crazy-max/docker-samba is the definitive source.
Read full README in the tab above.
Still deciding about docker-samba?
One click hands the question to an AI along with this page — see what it says about docker-samba.