Repository files navigation

Docker container ofSamba, an implementation of the Windows SMB networking protocol.

Via Docker Compose:

services:samba:image:dockurr/sambacontainer_name:sambaenvironment:NAME:"Data"USER:"samba"PASS:"secret"ports:      -445:445volumes:      -./samba:/storagerestart:always

Via Docker CLI:

docker run -it --rm --name samba -p 445:445 -e"USER=samba" -e"PASS=secret" -v${PWD:-.}/samba:/storage dockurr/samba

To change the location of the shared folder, include the following bind mount in your compose file:

volumes:  -./samba:/storage

Replace the example path./samba with the desired folder or named volume.

You can change the display name of the shared folder by adding the following environment variable:

environment:NAME:"Data"

To connect to the shared folder enter:\\192.168.0.2\Data in Windows Explorer.

You can set theUSER andPASS environment variables to modify the credentials from their default values: usersamba with passwordsecret.

environment:USER:"samba"PASS:"secret"

You can setUID andGID environment variables to change the user and group ID.

environment:UID:"1002"GID:"1005"

To mark the share as read-only, add the variableRW: "false".

If you need more advanced features, you can completely override the default configuration by modifying thesmb.conf file in this repo, and binding your custom config to the container like this:

volumes:  -./smb.conf:/etc/samba/smb.conf

If you want to configure multiple users, you can bind theusers.conf file to the container as follows:

volumes:  -./users.conf:/etc/samba/users.conf

Each line inside that file contains a: separated list of attributes describing the user to be created.

username:UID:groupname:GID:password:homedir

where:

• username The textual name of the user.
• UID The numerical id of the user.
• groupname The textual name of the primary user group.
• GID The numerical id of the primary user group.
• password The clear text password of the user. The password can not contain:,\n or\r.
• homedir Optional field for setting the home directory of the user.