Skip to content

Commit 8b58bcc

Browse files
committed
Remove obsolete file sharing information
1 parent f6b590c commit 8b58bcc

File tree

2 files changed

+2
-142
lines changed

2 files changed

+2
-142
lines changed

docker-for-windows/index.md

Lines changed: 1 addition & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -232,12 +232,7 @@ Choose the local directories you'd like to share with your Linux containers. Fil
232232
not for Windows containers. For Linux containers, you need to share the drive
233233
where the Dockerfile and volume are located. Otherwise, you get `file not found` or `cannot start service` errors at runtime. See [Volume mounting requires shared drives for Linux containers](troubleshoot.md#volume-mounting-requires-shared-drives-for-linux-containers).
234234
235-
File sharing permissions are tied to the credentials you provide here. If
236-
you run `docker` commands under a different username than the one configured
237-
here, your containers cannot access the mounted volumes.
238-
239-
When you select a local drive to share with your containers, Docker Desktop prompts you for your Windows system (domain)
240-
username and password. Enter your credentials and then click **Apply & Restart**.
235+
**Apply & Restart** makes the directory available to containers using Docker's bind mount (`-v`) feature.
241236
242237
> Tips on shared drives, permissions, and volume mounts
243238
>
@@ -248,30 +243,11 @@ username and password. Enter your credentials and then click **Apply & Restart**
248243
>
249244
* Docker Desktop sets permissions to read/write/execute for users, groups and others [0777 or a+rwx](http://permissions-calculator.org/decode/0777/).
250245
This is not configurable. See [Permissions errors on data directories for shared volumes](troubleshoot.md#permissions-errors-on-data-directories-for-shared-volumes).
251-
>
252-
* Ensure the domain user has access to shared drives, as described in [Verify domain user has permissions for shared drives](troubleshoot.md#verify-domain-user-has-permissions-for-shared-drives-volumes).
253246
>
254247
* You can share local drives with your _containers_ but not with Docker Machine
255248
nodes. See the FAQ, [Can I share local drives and filesystem with my Docker Machine VMs?](faqs.md#can-i-share-local-drives-and-filesystem-with-my-docker-machine-vms).
256249
>
257250
258-
#### Firewall rules for shared drives
259-
260-
Shared drives require port 445 to be open between the host machine and the
261-
virtual machine that runs Linux containers. Docker detects if port 445 is closed
262-
and shows the following message when you try to add a shared drive:
263-
264-
![Port 445 blocked](images/shared-drive-firewall-blocked.png){:width="600px"}
265-
266-
To share the drive, allow connections between the Windows host machine and the
267-
virtual machine in Windows Firewall or your third party firewall software. You
268-
do not need to open port 445 on any other network.
269-
270-
By default, allow connections to `10.0.75.1` on port 445 (the Windows host) from
271-
`10.0.75.2` (the virtual machine). If your firewall rules seem correct, you may
272-
need to toggle or
273-
[reinstall the File and Print sharing service on the Hyper-V virtual network card](http://stackoverflow.com/questions/42203488/settings-to-windows-firewall-to-allow-docker-for-windows-to-share-drive/43904051#43904051)
274-
275251
#### Shared drives on demand
276252
277253
You can share a drive "on demand" the first time a particular mount is requested.

docker-for-windows/troubleshoot.md

Lines changed: 1 addition & 117 deletions
Original file line numberDiff line numberDiff line change
@@ -117,15 +117,10 @@ volume defaults at container runtime, you need to either use non-host-mounted
117117
volumes or find a way to make the applications work with the default file
118118
permissions.
119119

120-
Docker Desktop currently implements host-mounted volumes based on [Microsoft SMB
121-
protocol](https://msdn.microsoft.com/en-us/library/windows/desktop/aa365233(v=vs.85).aspx), which does not support fine-grained, `chmod` control over these permissions.
122-
123120
See also, [Can I change permissions on shared volumes for container-specific
124121
deployment
125122
requirements?](faqs.md#can-i-change-permissions-on-shared-volumes-for-container-specific-deployment-requirements)
126-
in the FAQs, and for more of an explanation, the GitHub issue, [Controlling
127-
Unix-style perms on directories passed through from shared Windows
128-
drives](https://github.com/docker/docker.github.io/issues/3298).
123+
in the FAQs.
129124

130125
#### inotify on shared drives does not work
131126

@@ -153,117 +148,6 @@ containers). Click ![whale menu](images/whale-x.png){: .inline}
153148
and then **Settings** > **Shared Drives** and share the drive that contains the
154149
Dockerfile and volume.
155150

156-
#### Verify domain user has permissions for shared drives (volumes)
157-
158-
> **Tip**: Shared drives are only required for volume mounting [Linux
159-
> containers](index.md#switch-between-windows-and-linux-containers), not Windows
160-
> containers.
161-
162-
Permissions to access shared drives are tied to the username and password you
163-
use to set up [shared drives](index.md#shared-drives). If you run `docker`
164-
commands and tasks under a different username than the one used to set up shared
165-
drives, your containers don't have permissions to access the mounted volumes.
166-
The volumes show as empty.
167-
168-
The solution to this is to switch to the domain user account and reset
169-
credentials on shared drives.
170-
171-
Here is an example of how to debug this problem, given a scenario where you
172-
shared the `C` drive as a local user instead of as the domain user. Assume the
173-
local user is `samstevens` and the domain user is `merlin`.
174-
175-
1. Make sure you are logged in as the Windows domain user (for our example,
176-
`merlin`).
177-
178-
2. Run `net share c` to view user permissions for `<host>\<username>, FULL`.
179-
180-
```
181-
> net share c
182-
183-
Share name C
184-
Path C:\
185-
Remark
186-
Maximum users No limit
187-
Users SAMSTEVENS
188-
Caching Caching disabled
189-
Permission windowsbox\samstevens, FULL
190-
```
191-
192-
3. Run the following command to remove the share.
193-
194-
```
195-
> net share c /delete
196-
```
197-
198-
4. Re-share the drive via the [Shared Drives dialog](index.md#shared-drives),
199-
and provide the Windows domain user account credentials.
200-
201-
5. Re-run `net share c`.
202-
203-
```
204-
> net share c
205-
206-
Share name C
207-
Path C:\
208-
Remark
209-
Maximum users No limit
210-
Users MERLIN
211-
Caching Caching disabled
212-
Permission windowsbox\merlin, FULL
213-
```
214-
215-
See also, the related issue on GitHub, [Mounted volumes are empty in the
216-
container](https://github.com/docker/for-win/issues/25).
217-
218-
#### Volume mounts from host paths use a `nobrl` option to override database locking
219-
220-
You may encounter problems using volume mounts on the host, depending on the
221-
database software and which options are enabled. Docker Desktop for Windows uses
222-
[SMB/CIFS
223-
protocols](https://msdn.microsoft.com/en-us/library/windows/desktop/aa365233(v=vs.85).aspx)
224-
to mount host paths, and mounts them with the `nobrl` option, which prevents
225-
lock requests from being sent to the database server
226-
([docker/for-win#11](https://github.com/docker/for-win/issues/11),
227-
[docker/for-win#694](https://github.com/docker/for-win/issues/694)). This is
228-
done to ensure container access to database files shared from the host. Although
229-
it solves the over-the-network database access problem, this "unlocked" strategy
230-
can interfere with other aspects of database functionality (for example,
231-
write-ahead logging (WAL) with SQLite, as described in
232-
[docker/for-win#1886](https://github.com/Sonarr/Sonarr/issues/1886)).
233-
234-
If possible, avoid using shared drives for volume mounts on the host with
235-
network paths, and instead mount on the MobyVM, or create a [data
236-
volume](/engine/tutorials/dockervolumes.md#data-volumes) (named volume) or [data
237-
container](/engine/tutorials/dockervolumes.md#creating-and-mounting-a-data-volume-container).
238-
See also, the [volumes key under service
239-
configuration](/compose/compose-file/index.md#volumes) and the [volume
240-
configuration
241-
reference](/compose/compose-file/index.md#volume-configuration-reference) in the
242-
Compose file documentation.
243-
244-
#### Local security policies can block shared drives and cause login errors
245-
246-
You need permissions to mount shared drives to use the Docker Desktop for Windows
247-
[shared drives](index.md#shared-drives) feature.
248-
249-
If local policy prevents this, you get errors when you attempt to enable shared
250-
drives on Docker. This is not something Docker can resolve, since you do need
251-
these permissions to use the feature.
252-
253-
Here are snip-its from example error messages:
254-
255-
```none
256-
Logon failure: the user has not been granted the requested logon type at
257-
this computer.
258-
259-
[19:53:26.900][SambaShare ][Error ] Unable to mount C drive: mount
260-
error(5): I/O error Refer to the mount.cifs(8) manual page (e.g. man mount.cifs)
261-
mount: mounting //10.0.75.1/C on /c failed: Invalid argument
262-
```
263-
264-
See also, <a href="https://github.com/docker/for-win/issues/98">Docker for
265-
Windows issue #98</a>.
266-
267151
#### Understand symlinks limitations
268152

269153
Symlinks work within and across containers. However, symlinks created outside of

0 commit comments

Comments
 (0)