kongkrit/samba repository overview

⁠Samba

• my github https://github.com/kongkrit/samba⁠
• forked from elswork/samba⁠ - github⁠

A Docker⁠ file to build images for many platforms (linux/amd64, linux/arm64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6) with a installation of Samba⁠ that is the standard Windows interoperability suite of programs for Linux and Unix. This is my own Multi-architecture docker recipe.

⁠Thanks to

• Samba⁠
• dastrasmue rpi-samba⁠

⁠Details

• GitHub⁠
• Deft.Work my personal blog⁠

Docker Hub	Docker Pulls	Docker Stars	Size/Layers
samba⁠

⁠Build Instructions

Build for amd64, armv7l, aarch64 architecture (thanks to its Multi-Arch⁠ base image)

docker build -t elswork/samba .

⁠Usage

I use it to share files between Linux and Windows, but Samba has many other capabilities.

ATTENTION: This is a recipe highly adapted to my needs, it might not fit yours. Deal with local filesystem permissions, container permissions and Samba permissions is a Hell, so I've made a workarround to keep things as simple as possible. I want avoid that the usage of this conainer would affect current file permisions of my local system, so, I've "synchronized" the owner of the path to be shared with Samba user. This mean that some commitments and limitations must be assumed.

Container will be configured as samba sharing server and it just needs:

• host directories to be mounted,
• users (one or more uid:gid:username:usergroup:password tuples) provided,
• shares defined (name, path, users).

-u uid:gid:username:usergroup:password

• uid from user p.e. 1000
• gid from group that user belong p.e. 1000
• username p.e. alice
• usergroup (wich user must belong) p.e. alice
• password (The password may be different from the user's actual password from your host filesystem)

-s name:path:show:rw:user1[,user2[,userN]]

• add a share that is accessible as 'name', exposing contents of 'path' directory. 'show' or 'hidden' controls whether this 'name' is browsable or not. this share also has read+write (rw) or read-only (ro)access control for specified logins user1, user2, .., userN

⁠Environmental Variable(s)

• DISABLE_SOCKET_OPTIONS, by default, the [global] section of the container's smb.conf will contain the line:

  socket options = TCP_NODELAY SO_RCVBUF=8192 SO_SNDBUF=8192
  

  Copy
  This may cause slow transfer for some use cases. In order to disable this line, add -e DISABLE_SOCKET_OPTIONS=yes to docker run.

⁠Serve

Start a samba fileshare.

docker run -d -p 139:139 -p 445:445 \
  -- hostname any-host-name \ # Optional
  -e TZ=Europe/Madrid \ # Optional
  -v /any/path:/share/data \ # Replace /any/path with some path in your system owned by a real user from your host filesystem
  elswork/samba \
  -u "1000:1000:alice:alice:put-any-password-here" \ # At least the first user must match (password can be different) with a real user from your host filesystem
  -u "1001:1001:bob:bob:secret" \
  -u "1002:1002:guest:guest:guest" \
  -s "Backup directory:/share/backups:show:rw:alice,bob" \ 
  -s "Alice (private):/share/data/alice:show:rw:alice" \
  -s "Bob (private):/share/data/bob:hidden:rw:bob" \ # Bob's private share does not show up when user is browsing the shares
  -s "Documents (readonly):/share/data/documents:show:ro:guest,alice,bob"

This is my real usage command:

docker run -d -p 445:445 -e TZ=Europe/Madrid \
    -v /home/pirate/docker/makefile:/share/folder elswork/samba \
    -u "1000:1000:pirate:pirate:put-any-password-here" \
    -s "SmbShare:/share/folder:show:rw:pirate"

or this if the user that owns the path to be shared match with the user that raise up the container:

docker run -d -p 445:445 --hostname $HOSTNAME -e TZ=Europe/Madrid \
    -v /home/pirate/docker/makefile:/share/folder elswork/samba \
    -u "$(id -u):$(id -g):$(id -un):$(id -gn):put-any-password-here" \
    -s "SmbShare:/share/folder:show:rw:$(id -un)"

On Windows point your filebrowser to \\host-ip\ to preview site.

Sponsor me!⁠ Together we will be unstoppable.