Add readme

This commit is contained in:
Joe Biellik 2016-05-17 18:44:13 +01:00
parent 7a423015c8
commit 4d3e2af714

29
README.md Normal file
View file

@ -0,0 +1,29 @@
# Samba server
[Samba 4](https://www.samba.org/) server running under [s6 overlay](https://github.com/just-containers/s6-overlay) on [Alpine Linux](https://hub.docker.com/_/alpine/). Runs both `smbd` and `nmbd` services.
## Configuration
See [example directory](https://github.com/jcbiellikltd/docker-samba-server/tree/master/example) for sample config file.
## Quickstart
```
samba:
image: joebiellik/samba-server
volumes:
# You must provide a Samba config file
- ./smb.conf:/config/smb.conf
# Shares
- ~/projects:/mnt/projects
- ~/videos:/mnt/videos:ro
ports:
- "137:137/udp"
- "138:138/udp"
- "139:139/tcp"
- "445:445/tcp"
environment:
- USERNAME=joe
- PASSWORD=samba
```