Public | Automated Build

Last pushed: 2 years ago
Short Description
a simple and easy to use samba image
Full Description

forked from ewindisch/docker-samba with changes

  • use only one docker image
  • use exec for usermod
  • fix missing private path
  • mandatory: copy docker.template to docker

Samba for Docker

This runs a basic samba server underneath docker with a
number of limitations and constraints.

This supports a tdb backend and unix users. Unix
users are managed via a dedicated set of files for


These Docker containers must be configured so that
you may have users and working shares.

Share Paths (Docker)

It is necessary to tell Docker which directories on the host may
be shared into the container. If these directories were not visible
to the container, Samba would be unable to expose these shares to
the network.

Edit etc/defaults/docker to set your share paths:


These will all be bind-mounted to the samba-smbd container,
there is presently no way to disable any of these mounts. To disable
a share path, point it to an empty directory, edit smb.conf,
or edit; Ideally, edit smb.conf and both.

Samba Shares & Configuration

The default samba configuration should serve for very basic
needs within the constraints of what is possible and reasonable
within a Docker environment.

Still, it is likely that you'll want to change the configuration.

Edit etc/smb/smb.conf as desired and relaunch your containers.


User management is performed through tdb and standard
Unix password/shadow files. Edit these files within the
etc/ directory and relaunch your containers.

For convenience, a user management tool is available as:

$ ./docker-samba usermod [add|delete|password] <user> <password>

The password option is mandatory for 'add' and 'password'. If
supplied, the password is ignored for the 'delete' feature.


$ ./docker-samba build
$ ./docker-samba launch

The build process should only need to be performed once, unless
code changes have been made or an upgrade is being performed.

These commands MUST be run as root, or with a user granted
priviledges to build and launch docker containers.

Docker Pull Command
Source Repository