mirror of https://github.com/docker/docs.git
Add info about adding shared folders to Toolbox (#4622)
* Add info about adding shared folders to Toolbox * copyedits and formatting, added link to Speccy per Gwen in Windows systems check topic Signed-off-by: Victoria Bialas <victoria.bialas@docker.com> * copyedits Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
This commit is contained in:
Misty Stanley-Jones
Victoria Bialas
parent
34cd249844
commit
d4c2079ddf
|
|
@ -118,33 +118,35 @@ Virtual Box VM, it maintains its configuration between uses.
|
||||||
|
|
||||||
The terminal does a number of things to set up Docker Quickstart Terminal for you.
|
The terminal does a number of things to set up Docker Quickstart Terminal for you.
|
||||||
|
|
||||||
Last login: Sat Jul 11 20:09:45 on ttys002
|
```
|
||||||
bash '/Applications/Docker Quickstart Terminal.app/Contents/Resources/Scripts/start.sh'
|
Last login: Sat Jul 11 20:09:45 on ttys002
|
||||||
Get http:///var/run/docker.sock/v1.19/images/json?all=1&filters=%7B%22dangling%22%3A%5B%22true%22%5D%7D: dial unix /var/run/docker.sock: no such file or directory. Are you trying to connect to a TLS-enabled daemon without TLS?
|
bash '/Applications/Docker Quickstart Terminal.app/Contents/Resources/Scripts/start.sh'
|
||||||
Get http:///var/run/docker.sock/v1.19/images/json?all=1: dial unix /var/run/docker.sock: no such file or directory. Are you trying to connect to a TLS-enabled daemon without TLS?
|
Get http:///var/run/docker.sock/v1.19/images/json?all=1&filters=%7B%22dangling%22%3A%5B%22true%22%5D%7D: dial unix /var/run/docker.sock: no such file or directory. Are you trying to connect to a TLS-enabled daemon without TLS?
|
||||||
-bash: lolcat: command not found
|
Get http:///var/run/docker.sock/v1.19/images/json?all=1: dial unix /var/run/docker.sock: no such file or directory. Are you trying to connect to a TLS-enabled daemon without TLS?
|
||||||
|
-bash: lolcat: command not found
|
||||||
|
|
||||||
mary at meepers in ~
|
mary at meepers in ~
|
||||||
$ bash '/Applications/Docker Quickstart Terminal.app/Contents/Resources/Scripts/start.sh'
|
$ bash '/Applications/Docker Quickstart Terminal.app/Contents/Resources/Scripts/start.sh'
|
||||||
Creating Machine dev...
|
Creating Machine dev...
|
||||||
Creating VirtualBox VM...
|
Creating VirtualBox VM...
|
||||||
Creating SSH key...
|
Creating SSH key...
|
||||||
Starting VirtualBox VM...
|
Starting VirtualBox VM...
|
||||||
Starting VM...
|
Starting VM...
|
||||||
To see how to connect Docker to this machine, run: docker-machine env dev
|
To see how to connect Docker to this machine, run: docker-machine env dev
|
||||||
Starting machine dev...
|
Starting machine dev...
|
||||||
Setting environment variables for machine dev...
|
Setting environment variables for machine dev...
|
||||||
|
|
||||||
## .
|
## .
|
||||||
## ## ## ==
|
## ## ## ==
|
||||||
## ## ## ## ## ===
|
## ## ## ## ## ===
|
||||||
/"""""""""""""""""\___/ ===
|
/"""""""""""""""""\___/ ===
|
||||||
~~~ {~~ ~~~~ ~~~ ~~~~ ~~~ ~ / ===- ~~~
|
~~~ {~~ ~~~~ ~~~ ~~~~ ~~~ ~ / ===- ~~~
|
||||||
\______ o __/
|
\______ o __/
|
||||||
\ \ __/
|
\ \ __/
|
||||||
\____\_______/
|
\____\_______/
|
||||||
|
|
||||||
The Docker Quick Start Terminal is configured to use Docker with the "default" VM.
|
The Docker Quick Start Terminal is configured to use Docker with the "default" VM.
|
||||||
|
```
|
||||||
|
|
||||||
3. Click your mouse in the terminal window to make it active.
|
3. Click your mouse in the terminal window to make it active.
|
||||||
|
|
||||||
|
|
@ -190,6 +192,49 @@ Virtual Box VM, it maintains its configuration between uses.
|
||||||
For more examples and ideas, visit:
|
For more examples and ideas, visit:
|
||||||
https://docs.docker.com/userguide/
|
https://docs.docker.com/userguide/
|
||||||
|
|
||||||
|
## Optional: Add shared directories
|
||||||
|
|
||||||
|
By default, Toolbox only has access to the `/Users` directory and mounts it into
|
||||||
|
the VMs at `/Users`. If your project lives elsewhere or needs access to other
|
||||||
|
directories on the host filesystem, you can add them.
|
||||||
|
|
||||||
|
### Use the VirtualBox GUI
|
||||||
|
|
||||||
|
You can configure shared folders in the VirtualBox UI.
|
||||||
|
|
||||||
|
1. Open the VirtualBox UI.
|
||||||
|
|
||||||
|
2. Click the **Settings** gear, then go to **Shared Folders**.
|
||||||
|
|
||||||
|
3. Select any existing listing under **Machine Folders**, then
|
||||||
|
click the **+** icon.
|
||||||
|
|
||||||
|
* Choose the **Folder Path** on the host, enter the **Folder Name**
|
||||||
|
for within the VM (or take the default, which is the same name
|
||||||
|
as on the host), and configure any additional options you need.
|
||||||
|
|
||||||
|
* Choose **Auto-mount** if you want the folder to automatically
|
||||||
|
be mounted into the VM, and choose **Make Permanent** for it
|
||||||
|
to be considered a permanently shared folder.
|
||||||
|
|
||||||
|
4. Click **OK** to add the new folder to the Shared Folders list.
|
||||||
|
|
||||||
|
5. Click **OK** again to save your changes and exit the Settings dialog.
|
||||||
|
|
||||||
|
### Use the command line
|
||||||
|
|
||||||
|
You can configure shared folders using a command like the following:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ mount -t vboxsf -o uid=1000,gid=50 your-other-share-name /some/mount/location
|
||||||
|
```
|
||||||
|
|
||||||
|
This command mounts `/some/mount/location` into the VM at `/your-other-share-hame`,
|
||||||
|
owned by UID 1000 and GID 50.
|
||||||
|
|
||||||
|
> **Note**: The autommount and permanent mount options are not supported using
|
||||||
|
> the command line.
|
||||||
|
|
||||||
## How to uninstall Toolbox
|
## How to uninstall Toolbox
|
||||||
|
|
||||||
Removing Toolbox involves removing all the Docker components it includes.
|
Removing Toolbox involves removing all the Docker components it includes.
|
||||||
|
|
|
||||||
|
|
@ -73,7 +73,7 @@ To verify your machine meets these requirements, do the following:
|
||||||
<br>
|
<br>
|
||||||
**For Windows 7**
|
**For Windows 7**
|
||||||
|
|
||||||
Run the [Microsoft® Hardware-Assisted Virtualization Detection Tool](http://www.microsoft.com/en-us/download/details.aspx?id=592) and follow the on-screen instructions.
|
Run a tool like the [Microsoft® Hardware-Assisted Virtualization Detection Tool](http://www.microsoft.com/en-us/download/details.aspx?id=592){: target="_blank" class="_"} or [Speccy](https://www.piriform.com/speccy){: target="_blank" class="_"}, and follow the on-screen instructions.
|
||||||
<br><br>
|
<br><br>
|
||||||
3. Verify your Windows OS is 64-bit (x64)
|
3. Verify your Windows OS is 64-bit (x64)
|
||||||
|
|
||||||
|
|
@ -190,6 +190,34 @@ Typically, the above steps work out-of-the-box, but some scenarios can cause pro
|
||||||
A Windows specific problem you might encounter has to do with the NDIS6 host network filter driver, which is known to cause issues on some Windows
|
A Windows specific problem you might encounter has to do with the NDIS6 host network filter driver, which is known to cause issues on some Windows
|
||||||
versions. For Windows Vista systems and newer, VirtualBox installs NDIS6 driver by default. Issues can range from system slowdowns to networking problems for the virtual machine (VM). If you notice problems, **re-run the Docker Toolbox installer**, and select the option to _**install VirtualBox with the NDIS5 driver**_.
|
versions. For Windows Vista systems and newer, VirtualBox installs NDIS6 driver by default. Issues can range from system slowdowns to networking problems for the virtual machine (VM). If you notice problems, **re-run the Docker Toolbox installer**, and select the option to _**install VirtualBox with the NDIS5 driver**_.
|
||||||
|
|
||||||
|
## Optional: Add shared directories
|
||||||
|
|
||||||
|
By default, Toolbox only has access to the `C:\Users` directory and mounts it into
|
||||||
|
the VMs at `/c/Users`.
|
||||||
|
|
||||||
|
> **Note**: Within the VM path, `c` is lowercase and the `Users` is capitalized.
|
||||||
|
|
||||||
|
If your project lives elsewhere or needs access to other
|
||||||
|
directories on the host filesystem, you can add them, using the VirtualBox UI.
|
||||||
|
|
||||||
|
1. Open the VirtualBox UI.
|
||||||
|
|
||||||
|
2. Click the **Settings** gear, then go to **Shared Folders**.
|
||||||
|
|
||||||
|
3. Select any existing listing under **Machine Folders**, then
|
||||||
|
click the **+** icon.
|
||||||
|
|
||||||
|
* Choose the **Folder Path** on the host, enter the **Folder Name**
|
||||||
|
for within the VM (or take the default, which is the same name
|
||||||
|
as on the host), and configure any additional options you need.
|
||||||
|
|
||||||
|
* Choose **Auto-mount** if you want the folder to automatically
|
||||||
|
be mounted into the VM, and choose **Make Permanent** for it
|
||||||
|
to be considered a permanently shared folder.
|
||||||
|
|
||||||
|
4. Click **OK** to add the new folder to the Shared Folders list.
|
||||||
|
|
||||||
|
5. Click **OK** again to save your changes and exit the Settings dialog.
|
||||||
|
|
||||||
## How to uninstall Toolbox
|
## How to uninstall Toolbox
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue