-
Notifications
You must be signed in to change notification settings - Fork 10.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add docs page on setting up Linux for Gatsby (#4716)
* new page an title * add in outline * build tools * node-install * links and preamble * debian too * Update gatsby-on-linux.md * Copy edits * Copy edits * Update gatsby-on-linux.md
- Loading branch information
1 parent
c707cd1
commit ea3c4a2
Showing
1 changed file
with
69 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,69 @@ | ||
--- | ||
title: Gatsby on Linux | ||
--- | ||
# Linux | ||
|
||
TODO | ||
|
||
## Windows Subsystem Linux (WSL) | ||
|
||
As of October 17th 2017, Windows 10 ships with WSL and Linux distributions are available via the [Windows Store], there are several different distributions to use which can be configured via `wslconfig` if you have more than one distribution installed. | ||
|
||
```sh | ||
# set default distribution to Ubuntu | ||
wslconfig /setdefault ubuntu | ||
``` | ||
|
||
### Using Windows Subsystem Linux: Ubuntu | ||
|
||
If you have a fresh install of Ubuntu then update and upgrade: | ||
|
||
```sh | ||
sudo apt update | ||
sudo apt -y upgrade | ||
``` | ||
|
||
>Only use `-y` if you're happy to upgrade to the latest versions of the software. | ||
**Build tools** | ||
|
||
To compile and install native addons from npm you may also need to install build tools for `node-gyp`: | ||
|
||
```sh | ||
sudo apt install -y build-essential | ||
``` | ||
|
||
**Install node** | ||
|
||
Following the install instructions on nodejs.org leaves a slightly broken install (i.e. permission errors when trying to `npm install`). Instead try installing node versions using [n] which you can install with [n-install]: | ||
|
||
```sh | ||
curl -L https://git.io/n-install | bash | ||
``` | ||
|
||
There are other alternatives for managing you node versions such as [nvm] but this is known to slow down [bash startup] on WSL. | ||
|
||
### Using Windows Subsystem Linux: Debian | ||
|
||
Debian setup is nearly identical to Ubuntu except for the additional installs of `git` and `libpng-dev`. | ||
|
||
```sh | ||
sudo apt update | ||
sudo apt -y upgrade | ||
sudo apt install build-essential | ||
sudo apt install git | ||
sudo apt install libpng-dev | ||
``` | ||
|
||
Or to install all at the same time and approve (y) all installs: | ||
|
||
```sh | ||
sudo apt update && sudo apt -y upgrade && sudo apt install build-essential && sudo apt install git && sudo apt install libpng-dev | ||
``` | ||
|
||
<!-- links --> | ||
[windows store]: https://www.microsoft.com/en-us/store/p/ubuntu/9nblggh4msv6 | ||
[n]: https://github.com/tj/n | ||
[n-install]: https://github.com/mklement0/n-install | ||
[nvm]: https://github.com/creationix/nvm | ||
[bash startup]: https://github.com/Microsoft/WSL/issues/776#issuecomment-266112578 |