dockurr/samba

Docker container of https://www.samba.org/, an implementation of the Windows SMB networking protocol.

Usage 🐳

Docker Compose:

yaml
services:
  samba:
    image: dockurr/samba
    container_name: samba
    environment:
      NAME: "Data"
      USER: "samba"
      PASS: "secret"
    ports:
      - 445:445
    volumes:
      - ./samba:/storage
    restart: always

Docker CLI:

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

Configuration ⚙️

How do I choose the location of the shared folder?

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

yaml
volumes:
  - ./samba:/storage

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

How do I modify the display name of the shared folder?

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

yaml
environment:
  NAME: "Data"

How do I connect to the shared folder?

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

[!NOTE] Replace the example IP address above with that of your host.

How do I modify the default credentials?

You can set the USER and PASS environment variables to modify the credentials from their default values: user samba with password secret.

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

How do I modify the permissions?

You can set UID and GID environment variables to change the user and group ID.

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

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

How do I modify other settings?

If you need more advanced features, you can completely override the default configuration by modifying the https://github.com/dockur/samba/blob/master/smb.conf file in this repo, and binding your custom config to the container like this:

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

How do I configure multiple users?

If you want to configure multiple users, you can bind the https://github.com/dockur/samba/blob/master/users.conf file to the container as follows:

yaml
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.

Stars 🌟

https://raw.githubusercontent.com/star-stats/stars/refs/heads/data/charts/dockur-samba.svg](https://github.com/dockur/samba/stargazers)