Skip to content

Latest commit

 

History

History
102 lines (76 loc) · 1.75 KB

README.md

File metadata and controls

102 lines (76 loc) · 1.75 KB

Linux SMB Role

Setup role for deploying a mapped SMB share onto a host

Overview

Will create a mount directory where a given set of SMB shares can be mapped into.

Default behavior mounts the shares via a serviced entry so that they will persist reboots. An optional switch smb__mount_temp will mount them as ephemeral shares onto the host.

Default Vars

smb__user: user
smb__pass: password
  • Default credentials for the SMB user
  • Will be stored as root-protected file on the host
smb__mount_temp: false
  • Will mount the share as ephemeral mount
  • Only connects the share, will be gone after reboot
smb__server_ip: 10.0.0.2
  • SMB server address
  • Must be a valid IP address
smb__server_name: FILES
  • Hostname of the server
  • Will be added as optional hostname in the hosts file
smb__mount_dir: /media
  • Mount path inside the host
  • Every SMB share will be mounted in here
smb__targets:
  - { share_name: "library", mount_point: "library" }
  • List of SMB share names to include
  • Contains the SMB hosts share name (exported SMB name) and the name of the mount point inside the host
smb__uid: 1000
smb__gid: 1000
  • UID and GID for the given shares to set
  • May be set to the local hosts UID and GID
smb__perms: rw
  • Default permissions for the deployed SMB shares
smb__charset: utf8
  • Default charset to use inside the SMB share
  • Imported on filesystem level
smb__timeout: 30
  • Timeout when trying to mount the SMB share
smb__automount_timeout: 300
  • Timeout for all directories as automount directories
  • Will disconnect the shares after given seconds