9 Storage pool type: `cifs`
11 The CIFS backend extends the directory backend, so that no manual
12 setup of a CIFS mount is needed. Such a storage can be added directly
13 through the {pve} API or the web UI, with all our backend advantages,
14 like server heartbeat check or comfortable selection of exported
20 The backend supports all common storage properties, except the shared
21 flag, which is always set. Additionally, the following CIFS special
22 properties are available:
26 Server IP or DNS name. Required.
28 TIP: To avoid DNS lookup delays, it is usually preferable to use an IP
29 address instead of a DNS name - unless you have a very reliable DNS
30 server, or list the server in the local `/etc/hosts` file.
34 CIFS share to use (get available ones with `pvesm scan cifs <address>` or the
39 The username for the CIFS storage. Optional, defaults to `guest'.
43 The user password. Optional.
44 It will be saved in a file only readable by root
45 (`/etc/pve/priv/storage/<STORAGE-ID>.pw`).
49 Sets the user domain (workgroup) for this storage. Optional.
53 SMB protocol Version. Optional, default is `3`.
54 SMB1 is not supported due to security issues.
58 The local mount point. Optional, defaults to `/mnt/pve/<STORAGE_ID>/`.
62 Overrides for the default directory layout. Optional.
66 Additional CIFS mount options (see `man mount.cifs`). Some options are set
67 automatically and shouldn't be set here. {pve} will always set the option
68 `soft`. Depending on the configuration, these options are set automatically:
69 `username`, `credentials`, `guest`, `domain`, `vers`.
73 The subdirectory of the share to mount. Optional, defaults to the root directory
76 .Configuration Example (`/etc/pve/storage.cfg`)
83 options noserverino,echo_interval=30
93 CIFS does not support snapshots on a storage level. But you may use
94 `qcow2` backing files if you still want to have snapshots and cloning
97 .Storage features for backend `cifs`
98 [width="100%",cols="m,m,3*d",options="header"]
99 |==============================================================================
100 |Content types |Image formats |Shared |Snapshots |Clones
101 |images rootdir vztmpl iso backup snippets |raw qcow2 vmdk |yes |qcow2 |qcow2
102 |==============================================================================
107 You can get a list of exported CIFS shares with:
110 # pvesm scan cifs <server> [--username <username>] [--password]
113 Then you could add this share as a storage to the whole {pve} cluster
117 # pvesm add cifs <storagename> --server <server> --share <share> [--username <username>] [--password]
125 * link:/wiki/Storage[Storage]