lotus/documentation/en/installation/install-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 intalling Lotus you will be ready to [setup and run the daemon](en+setup.md).
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			```

Docs review and re-organization This: * Re-organizes the docs into sections that align with what docs.filecoin.io becoming: * An installation section * A "getting started" section (lotus client focused) * A "storing" section (lotus client focused) * A "mining" section (miner focused) * A "build" section (developer focused) * An legacy "architecture" section is left in the last place. A few high-value documentation pages have been reviewed and updated with the latest recommendations: * Installation section and lotus setup * Miner setup * etc. ... Other pages have been correctly merged into the new relevant sections. Some pages have not been touched. The filesystem layout of the documentation has been changed into folders corresponding to the sections (as requested by @cw). Some pages that were not linked at all and/or where hidden, have been moved to "unclassified". This should make the porting of the Lotus documentation to docs.filecoin.io much easier, while ensuring it is more up to date than it was before. For the moment, this breaks most links as link-aliasing is not supported in lotus-docs. 2020-08-31 15:11:01 +00:00			`After intalling Lotus you will be ready to [setup and run the daemon](en+setup.md).`