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
For the best experience developing Ember apps in Windows, we recommend using WSL 2.
12
+
13
+
Since build 20262 of Windows 10 [Windows Subsystem for Linux (WSL) 2](https://docs.microsoft.com/windows/wsl/install-win10)
14
+
is available. WSL allows you to run a Linux system on your Windows computer that allows
15
+
you to use some Linux tools and gives much better performance and file path resolution for
16
+
developing Ember on Windows.
17
+
18
+
Once you have followed the [guide to install WSL 2](https://docs.microsoft.com/windows/wsl/install-win10)
19
+
you can then install the latest Ubuntu from the Microsoft store (instructions are also
20
+
included in the guide).
21
+
22
+
<divclass="cta">
23
+
<divclass="cta-note">
24
+
<div class="cta-note-body">
25
+
<div class="cta-note-heading">Zoey says...</div>
26
+
<div class="cta-note-message">
27
+
Make sure that you aren't working in any folder under <code>/mnt/</code> as the performance isn't as good as working in your home directory (<em>'~'</em>) in WSL!
You will need to make sure that you have Node.js installed in your WSL environment, if you haven't already done so you can follow [this guide](https://docs.microsoft.com/en-us/windows/nodejs/setup-on-wsl2).
35
+
36
+
Open your terminal on your WSL environment (for more information you might want to follow [this guide](https://devblogs.microsoft.com/commandline/a-guide-to-invoking-wsl/)) and then clone your Ember app repository.
37
+
38
+
```shell
39
+
cd~
40
+
git clone your-repo
41
+
```
42
+
43
+
you can now install your dependencies and start the Ember app:
44
+
45
+
```shell
46
+
cd~/your-repo
47
+
npm i
48
+
npm start
49
+
```
50
+
51
+
IF you use VSCode, there is a useful plugin to make sure that it uses your WSL environment called ["Remote - WSL"](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl). For more information you can [follow this tutorial](https://code.visualstudio.com/docs/remote/wsl-tutorial).
52
+
9
53
### Performance
10
54
11
55
Although supported, Windows performance, at least by default, isn't as good as
@@ -75,46 +119,4 @@ as it decided to act on a package resulting in hard-to-debug race conditions.
75
119
`npm` 3 is a nearly complete rewrite of `npm`, fixing both issues. Windows users of
76
120
Ember CLI might want to make the switch to `npm` 3 to benefit from its
77
121
flat module installation (solving most issues involving long path names) as well
78
-
as its multi-stage installer.
79
-
80
-
### WSL 2
81
-
82
-
Since build 20262 of Windows 10 [Windows Subsystem for Linux (WSL) 2](https://docs.microsoft.com/windows/wsl/install-win10)
83
-
is available. WSL allows you to run a Linux system on your Windows computer that allows
84
-
you to use some Linux tools and should hopefully give us much better performance for
85
-
developing Ember on Windows.
86
-
87
-
Once you have followed the [guide to install WSL 2](https://docs.microsoft.com/windows/wsl/install-win10)
88
-
you can then install the latest Ubuntu from the Microsoft store (instructions are also
89
-
included in the guide).
90
-
91
-
<divclass="cta">
92
-
<divclass="cta-note">
93
-
<div class="cta-note-body">
94
-
<div class="cta-note-heading">Zoey says...</div>
95
-
<div class="cta-note-message">
96
-
Make sure that you aren't working in any folder under <code>/mnt/</code> as the performance isn't as good as working in your home directory (<em>'~'</em>) in WSL!
You will need to make sure that you have Node.js installed in your WSL environment, if you haven't already done so you can follow [this guide](https://docs.microsoft.com/en-us/windows/nodejs/setup-on-wsl2).
104
-
105
-
Open your terminal on your WSL environment (for more information you might want to follow [this guide](https://devblogs.microsoft.com/commandline/a-guide-to-invoking-wsl/)) and then clone your Ember app repository.
106
-
107
-
```shell
108
-
cd~
109
-
git clone your-repo
110
-
```
111
-
112
-
you can now install your dependencies and start the Ember app:
113
-
114
-
```shell
115
-
cd~/your-repo
116
-
npm i
117
-
npm start
118
-
```
119
-
120
-
IF you use VSCode, there is a useful plugin to make sure that it uses your WSL environment called ["Remote - WSL"](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl). For more information you can [follow this tutorial](https://code.visualstudio.com/docs/remote/wsl-tutorial).
0 commit comments