You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Nov 19, 2024. It is now read-only.
Copy file name to clipboardExpand all lines: guides/v2.0/install-gde/docker/docker-ref.md
+30-6Lines changed: 30 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -49,7 +49,7 @@ Before you continue, make sure you install and configure the following:
49
49
</div>
50
50
51
51
#### Set up Docker file sharing {#devbox-docker-file-share}
52
-
For the Magento application to work, the application must be installed in a directory that Docker uses for file sharing.
52
+
For the Magento application to work, the application must be installed in a folder that Docker uses for file sharing.
53
53
54
54
**Windows**
55
55
@@ -72,24 +72,39 @@ To set up Docker file sharing on the Mac OS:
72
72
2. From the pop-up menu, click **Preferences**.
73
73
3. In the Preferences dialog box, click the **File Sharing** tab.
74
74
75
-
This tab page displays all shared directories that Docker currently knows about. Make sure you install Magento in a directory listed on this tab page.
75
+
This tab page displays all shared directories that Docker currently knows about. Make sure you install Magento in a folder listed on this tab page.
76
76
5. To add additional directories, follow the prompts on your screen or consult Docker documentation.
77
77
78
78
{% endcollapsibleh2 %}
79
79
80
+
<pid="devbox-fileshare"></p>{% collapsibleh2 How DevBox uses file sharing %}
81
+
82
+
DevBox runs in a Docker container, which is also referred to as the _guest operating system_. The Magento files and folders are located on your _host operating system_ (Windows or Mac OS). To facilitate development, Magento files and directories are shared by the guest and host operating systems.
83
+
84
+
When you make a change to files, the changes are automatically synchronized, regardless of which files you change. (In other words, if you change files on the host operating system, those files are synchronized with the guest operating system and vice versa.)
85
+
86
+
Use the following guidelines:
87
+
88
+
* New Magento DevBox installations: Files are shared in the `shared/webroot` folder relative to your Magento installation root folder.
89
+
90
+
The Magento installation root folder is typically a subfolder of the folder in which you extracted the `.zip` file you download from Magento.
91
+
* If you use an existing Magento installation with DevBox: Files are shared in the location to which you downloaded Magento.
<pid="devbox-download">{% collapsibleh2 How to download Magento code %}
101
+
<pid="devbox-download"></p>{% collapsibleh2 How to download Magento code %}
87
102
88
103
This section applies to you if you use an existing Magento installation with DevBox. This means you first download the Magento software using either [Composer]({{ page.baseurl }}install-gde/prereq/integrator_install.html) or a [compressed archive]({{ page.baseurl }}install-gde/prereq/zip_install.html) but you don't _install_ the software.
89
104
90
105
Downloading a compressed archive has potential issues on the Mac OS, which extracts known compressed file types like `.zip` to a folder. The folder contains files that have to be copied in a particular way; otherwise, the Magento DevBox doesn't perform properly.
91
106
92
-
If you download a compressed archive on the Mac OS, you must make sure to copy _all_ of the Magento code to an empty folder. In particular, you must copy all Apache [distributed configuration files](http://httpd.apache.org/docs/current/howto/htaccess.html){:target="_blank"}, named `.htaccess`, to the folder. `.htaccess` files are located in several Magento directories, including in the root directory.
107
+
If you download a compressed archive on the Mac OS, you must make sure to copy _all_ of the Magento code to an empty folder. In particular, you must copy all Apache [distributed configuration files](http://httpd.apache.org/docs/current/howto/htaccess.html){:target="_blank"}, named `.htaccess`, to the folder. `.htaccess` files are located in several Magento directories, including in the root folder.
93
108
94
109
Failure to copy `.htaccess` files causes the Magento application to function incorrectly because URL redirects won't work.
95
110
@@ -99,7 +114,7 @@ When you download a file on the Mac OS, the file is usually located in the `/Use
To make sure your existing Magento installation works it with DevBox, create an empty directory and copy all of the contents of the Magento compressed file to it as follows:
117
+
To make sure your existing Magento installation works it with DevBox, create an empty folder and copy all of the contents of the Magento compressed file to it as follows:
@@ -236,6 +251,15 @@ To provide you more control over your Magento installation, we enable you to cho
236
251
237
252
{% endcollapsibleh2 %}
238
253
254
+
## After the DevBox wizard completes
255
+
After you finish the DevBox wizard, you're prompted to download a `.zip` file to any folder on your system. When you extract the `.zip` file, your operating system might create another folder.
In the preceding example, the user downloaded `build-18c4e4d3c5a541f37e9cffd35f1bf74e.zip` to the `C:\magento` folder. Extracting the `.zip` created a subfolder. The installation script you must run is located in the subfolder.
When you run the installation script on Windows, an additional command window opens for Unison sync. You don't normally need to interact with this command window.
0 commit comments