2020-01-25 23:14:22 +00:00
---
title: smb
type: docs
---
2020-01-26 14:32:37 +00:00
[![Source Code ](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&logoColor=white )](https://gitea.rknet.org/ansible/xoxys.smb) [![Build Status ](https://img.shields.io/drone/build/ansible/xoxys.smb?logo=drone&server=https%3A%2F%2Fdrone.rknet.org )](https://drone.rknet.org/ansible/xoxys.smb) [![License: MIT ](https://img.shields.io/badge/License-MIT-blue.svg?label=license )](LICENSE)
2020-01-25 23:14:22 +00:00
Mount a list of smb shares.
* [Default Variables ](#default-variables )
* [smb_packages ](#smb-packages )
* [smb_shares ](#smb-shares )
* [Dependencies ](#dependencies )
---
## Default Variables
### smb_packages
#### Default value
```YAML
smb_packages:
- cifs-utils
```
### smb_shares
Add mount defined samba shares. You can specify samba credentials with username/password parameter. Credentials will be used in a credentials file and saved to `/root/.smbcredentials/` and not in the fstab directly.
#### Default value
```YAML
smb_shares: []
```
#### Example usage
```YAML
smb_shares:
- name: multimedia
source: //share.example.com/media
username: myuser
password: secure
mountpoint: /media/data
mountopts:
- acl
- uid=1000
- gid=1000
state: mounted
```
## Dependencies
None.