AnsiblePilot — Master Ansible Automation
AnsiblePilot is the leading resource for learning Ansible automation, DevOps, and infrastructure as code. Browse over 1,400 tutorials covering Ansible modules, playbooks, roles, collections, and real-world examples. Whether you are a beginner or an experienced engineer, our step-by-step guides help you automate Linux, Windows, cloud, containers, and network infrastructure.
Popular Topics
About Luca Berton
Luca Berton is an Ansible automation expert, author of 8 Ansible books published by Apress and Leanpub including "Ansible for VMware by Examples" and "Ansible for Kubernetes by Example", and creator of the Ansible Pilot YouTube channel. He shares practical automation knowledge through tutorials, books, and video courses to help IT professionals and DevOps engineers master infrastructure automation.
Ansible mount Module: Mount Filesystems, NFS, SMB/CIFS Shares (Guide) — Video Tutorial
How to mount filesystems with Ansible mount module (ansible.posix.mount). Mount NFS, SMB/CIFS, Windows shares, configure fstab.
What You'll Learn
- Ansible mount an SMB/CIFS filesystem
- Parameters
- code
- execution
- before execution
- after execution
- Secure the credentials (avoid plaintext passwords)
- Persistent mounts and unmounting
- Conclusion
- Related Articles
Full Tutorial Content
How to mount a Windows share in Linux SMB/CIFS with Ansible?
I'm going to show you a live Playbook with some simple Ansible code.
I'm Luca Berton and welcome to today's episode of Ansible Pilot
Ansible mount an SMB/CIFS filesystem
- ansible.posix.mount
- Control active and configured mount points
Today we're talking about the Ansible module mount.
The full name is `ansible.posix.mount`, which means that is part of the collection of modules "ansible.posix" to interact with POSIX platforms.
The purpose of the module is to Control active and configured mount points.
For Windows, use the `community.windows.win_mapped_drive` module instead.
Parameters
- path string - mount point (e.g. /mnt)
- state string - mounted / unmounted / present / absent / remounted
- src string - device or network volume
- fstype string - ext4, xfs, iso9660, nfs, cifs, etc.
- opts string - mount options
This module has many parameters to perform any task.
The only required are "path" and "state".
The parameter "path" specifies the path to the mount point (e.g. /mnt/).
The parameter "state" allows us to verify a specific state of the mount point. The options "mounted", "unmounted" and "remounted" change the device status. The "present" and "absent" options only change the `/etc/fstab` file.
The `src` parameter specifies the device or network volume for NFS or SMB/CIFS.
The `fstype` parameter specifies the filesystem type. For example: ext4, xfs, iso9660, nfs, cifs, etc.
The `opts` parameter allows us to specify some mount options, that vary for each filesystem type.
## Playbook
Let's jump in a real-life Ansible Playbook to mount an SMB/CIFS filesystem.
code
- mount_cifs.yml
```yaml
---
- name: mount module Playbook
hosts: all
become: true
vars:
uri: "//windows-pc/share"
username: "example@domain"
password: "password"
mountpoint: "/share"
tasks:
- name: utility present
ansible.builtin.package:
name: cifs-utils
state: present
- name: check mountpoint exist
ansible.builtin.file:
path: "{{ mountpoint }}"
state: directory
mode: '0755'
owner: root
group: root
- name: Mount network share
ansible.posix.mount:
src: "{{ uri }}"
path: "{{ mountpoint }}"
fstype: cifs
opts: 'username={{ username }},password={{ password }}'
state: mounted
```
execution
```bash
$ ansible-playbook -i Playbook/inventory mount\ drive/cifs.yml
PLAY [mount module Playbook] *********************************************************************************
TASK [Gathering Facts] ***********************************************************************************
ok: [demo.example.com]
TASK [utility present] ***********************************************************************************
changed: [demo.example.com]
TASK [check mountpoint exist] ****************************************************************************
changed: [demo.example.com]
TASK
About This Tutorial
- Author: Luca Berton
- Difficulty: Beginner
- Read time: 7 min
- Category: troubleshooting
Read the full written article: Ansible mount Module: Mount Filesystems, NFS, SMB/CIFS Shares (Guide)