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

Features ✨

• Provides an SMB/CIFS file server
• Configurable share name and credentials
• Supports multiple users via a list file
• Allows custom Samba configuration
• Works with Windows, macOS, and Linux clients
• Lightweight Alpine-based image

Usage 🐳

Docker Compose:

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:

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:

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:

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.

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.

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 smb.conf file in this repo, and binding your custom config to the container like this:

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

How do I configure multiple users?

If you want to configure multiple users, you can bind the users.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.

Stars 🌟

[build_url]: https://github.com/dockur/samba/ [hub_url]: https://hub.docker.com/r/dockurr/samba [tag_url]: https://hub.docker.com/r/dockurr/samba/tags [pkg_url]: https://github.com/dockur/samba/pkgs/container/samba

[Build]: https://github.com/dockur/samba/actions/workflows/build.yml/badge.svg [Size]: https://img.shields.io/docker/image-size/dockurr/samba/latest?color=066da5&label=size [Pulls]: https://img.shields.io/docker/pulls/dockurr/samba.svg?style=flat&label=pulls&logo=docker [Version]: https://img.shields.io/docker/v/dockurr/samba/latest?arch=amd64&sort=semver&color=066da5 [Package]: https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fipitio.github.io%2Fbackage%2Fdockur%2Fsamba%2Fsamba.json&query=%24.downloads&logo=github&style=flat&color=066da5&label=pulls