lotus/documentation/en/install-lotus-macos.md

# MacOS Instructions

## Get XCode Command Line Tools

To check if you already have the XCode Command Line Tools installed via the CLI, run:

```sh
xcode-select -p
```

If this command returns a path, you can move on to the next step. Otherwise, to install via the CLI, run:

```sh
xcode-select --install
```

To update, run:

```sh
sudo rm -rf /Library/Developer/CommandLineTools
xcode-select --install
```

## Get HomeBrew

We recommend that MacOS users use [HomeBrew](https://brew.sh) to install each the necessary packages.

Check if you have HomeBrew:

```sh
brew -v
```

This command returns a version number if you have HomeBrew installed and nothing otherwise.

In your terminal, enter this command to install Homebrew:

```sh
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```

Use the command `brew install` to install the following packages:

```sh
brew install go bzr jq pkg-config rustup
```

Clone

```sh
git clone https://github.com/filecoin-project/lotus.git
cd lotus/
```

Build

```sh
make clean && make all
sudo make install
```

After installing Lotus, you can run the `lotus` command directly from your CLI to see usage documentation. Next, you can join the [Lotus Testnet](https://docs.lotu.sh/en+join-testnet).
documentation: small copy updates 2019-12-04 15:39:41 +00:00			`# MacOS Instructions`

documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`## Get XCode Command Line Tools`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: fixes formatting issue and removes copy issue 2019-12-18 21:46:09 +00:00			`To check if you already have the XCode Command Line Tools installed via the CLI, run:`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			```sh
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`xcode-select -p`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			```

documentation: fixes formatting issue and removes copy issue 2019-12-18 21:46:09 +00:00			`If this command returns a path, you can move on to the next step. Otherwise, to install via the CLI, run:`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
			```sh
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`xcode-select --install`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			```

documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`To update, run:`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
			```sh
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`sudo rm -rf /Library/Developer/CommandLineTools`
			`xcode-select --install`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			```

documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`## Get HomeBrew`

documentation: fixes formatting issue and removes copy issue 2019-12-18 21:46:09 +00:00			`We recommend that MacOS users use [HomeBrew](https://brew.sh) to install each the necessary packages.`
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00
			`Check if you have HomeBrew:`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
			```sh
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`brew -v`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			```

documentation: fixes formatting issue and removes copy issue 2019-12-18 21:46:09 +00:00			`This command returns a version number if you have HomeBrew installed and nothing otherwise.`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`In your terminal, enter this command to install Homebrew:`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
			```sh
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			```

documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			Use the command `brew install` to install the following packages:
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
documentation: testnet update 2019-12-11 15:38:04 +00:00			`brew install go bzr jq pkg-config rustup`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

documentation: adds code block label 2019-12-18 18:48:15 +00:00			`Clone`
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			```sh
			`git clone https://github.com/filecoin-project/lotus.git`
			`cd lotus/`
			```
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00
documentation: adds code block label 2019-12-18 18:48:15 +00:00			`Build`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
documentation: testnet update 2019-12-11 15:38:04 +00:00			`make clean && make all`
documentation: latest updates from feedback across team 2019-12-09 12:53:40 +00:00			`sudo make install`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

documentation: fixes formatting issue and removes copy issue 2019-12-18 21:46:09 +00:00			After installing Lotus, you can run the `lotus` command directly from your CLI to see usage documentation. Next, you can join the [Lotus Testnet](https://docs.lotu.sh/en+join-testnet).