samba/README.md

120 lines
4.8 KiB
Markdown
Raw Normal View History

2015-08-16 01:52:19 +03:00
[![logo](https://raw.githubusercontent.com/dperson/samba/master/logo.jpg)](https://www.samba.org)
2015-01-02 07:03:52 +03:00
# Samba
Samba docker container
# What is Samba?
Since 1992, Samba has provided secure, stable and fast file and print services
for all clients using the SMB/CIFS protocol, such as all versions of DOS and
Windows, OS/2, Linux and many others.
# How to use this image
By default there are no shares configured, additional ones can be added.
## Hosting a Samba instance
sudo docker run -it -p 139:139 -p 445:445 -d dperson/samba
2015-01-02 07:03:52 +03:00
OR set local storage:
sudo docker run -it --name samba -p 139:139 -p 445:445 \
2015-01-02 07:03:52 +03:00
-v /path/to/directory:/mount \
-d dperson/samba
## Configuration
sudo docker run -it --rm dperson/samba -h
Usage: samba.sh [-opt] [command]
Options (fields in '[]' are optional, '<>' are required):
-h This help
-c "<from:to>" setup character mapping for file/directory names
required arg: "<from:to>" character mappings separated by ','
-g "<parameter>" Provide global option for smb.conf
required arg: "<parameter>" - IE: -g "log level = 2"
-i "<path>" Import smbpassword
required arg: "<path>" - full file path in container
-n Start the 'nmbd' daemon to advertise the shares
-p Set ownership and permissions on the shares
2017-05-25 17:48:21 +03:00
-r Disable recycle bin for shares
2017-10-08 21:47:27 +03:00
-S Disable SMB2 minimum version
-s "<name;/path>[;browse;readonly;guest;users;admins;writelist;comment]"
Configure a share
required arg: "<name>;</path>"
2015-01-02 07:03:52 +03:00
<name> is how it's called for clients
<path> path to share
NOTE: for the default values, just leave blank
[browsable] default:'yes' or 'no'
2015-01-02 07:03:52 +03:00
[readonly] default:'yes' or 'no'
[guest] allowed default:'yes' or 'no'
[users] allowed default:'all' or list of allowed users
2015-12-17 14:17:34 +03:00
[admins] allowed default:'none' or list of admin users
[writelist] list of users that can write to a RO share
[comment] description of share
-u "<username;password>[;ID;group]" Add a user
2015-01-02 07:03:52 +03:00
required arg: "<username>;<passwd>"
<username> for user
<password> for user
[ID] for user
[group] for user
-w "<workgroup>" Configure the workgroup (domain) samba should use
required arg: "<workgroup>"
<workgroup> for samba
-W Allow access wide symbolic links
-I Add an include option at the end of the smb.conf
required arg: "<include file path>"
<include file path> in the container, e.g. a bind mount
2015-01-02 07:03:52 +03:00
The 'command' (if provided and valid) will be run instead of samba
2018-09-23 17:31:44 +03:00
ENVIRONMENT VARIABLES
2015-01-02 07:03:52 +03:00
* `CHARMAP` - As above, configure character mapping
* `GLOBAL` - As above, configure a global option
* `IMPORT` - As above, import a smbpassword file
* `NMBD` - As above, enable nmbd
* `PERMISSIONS` - As above, set file permissions on all shares
* `RECYCLE` - As above, disable recycle bin
* `SHARE` - As above, setup a share
2017-10-08 21:47:27 +03:00
* `SMB` - As above, disable SMB2 minimum version
2017-10-20 20:43:12 +03:00
* `TZ` - Set a timezone, IE `EST5EDT`
* `USER` - As above, setup a user
* `WIDELINKS` - As above, allow access wide symbolic links
* `WORKGROUP` - As above, set workgroup
* `USERID` - Set the UID for the samba server
* `GROUPID` - Set the GID for the samba server
* `INCLUDE` - As above, add a smb.conf include
2015-01-02 07:03:52 +03:00
**NOTE**: if you enable nmbd (via `-n` or the `NMBD` environment variable), you
will also want to expose port 137 and 138 with `-p 137:137/udp -p 138:138/udp`.
2018-09-23 20:07:46 +03:00
**NOTE2**: there are reports that `-n` and `NMBD` only work if you have the
container configured to use the hosts network stack.
2015-01-02 07:03:52 +03:00
## Examples
Any of the commands can be run at creation with `docker run` or later with
2018-02-02 22:29:01 +03:00
`docker exec -it samba samba.sh` (as of version 1.3 of docker).
2015-01-02 07:03:52 +03:00
### Setting the Timezone
sudo docker run -it -e TZ=EST5EDT -p 139:139 -p 445:445 -d dperson/samba
2015-01-02 07:03:52 +03:00
### Start an instance creating users and shares:
sudo docker run -it -p 139:139 -p 445:445 -d dperson/samba \
2015-01-02 07:03:52 +03:00
-u "example1;badpass" \
-u "example2;badpass" \
-s "public;/share" \
-s "users;/srv;no;no;no;example1,example2" \
-s "example1 private;/example1;no;no;no;example1" \
-s "example2 private;/example2;no;no;no;example2"
# User Feedback
## Issues
If you have any problems with or questions about this image, please contact me
2017-08-29 15:46:12 +03:00
through a [GitHub issue](https://github.com/dperson/samba/issues).