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

# Ubuntu Instructions

These steps will install the following dependencies:

- go (1.14 or higher)
- gcc (7.4.0 or higher)
- git (version 2 or higher)
- bzr (some go dependency needs this)
- jq
- pkg-config
- opencl-icd-loader
- opencl driver (like nvidia-opencl on arch) (for GPU acceleration)
- opencl-headers (build)
- rustup (proofs build)
- llvm (proofs build)
- clang (proofs build)

Install dependencies

```sh
sudo add-apt-repository ppa:longsleep/golang-backports
sudo apt update
sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git bzr jq pkg-config golang-go
```

Install Rust 
_(this is an interactive installer)_
```sh
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

Clone the Lotus repository

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

Build the Lotus binaries from source and install

```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).

### Interopnet

If you seek a smaller network to test, you can join the `interopnet`. Please note that this network is meant for developers - it resets much more often, and is much smaller. To join this network, checkout the branch `interopnet` instead of `master` before building and installing;
```
git checkout interopnet
```

Please also note that this documentation (if viewed on the website) might not be up to date with the interopnet. For the latest documentation on the interopnet branch, see the [Lotus Documentation Interopnet Branch on GitHub](https://github.com/filecoin-project/lotus/tree/interopnet/documentation/en)
documentation: small copy updates 2019-12-04 15:39:41 +00:00			`# Ubuntu Instructions`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
documentation: small copy updates 2019-12-04 15:39:41 +00:00			`These steps will install the following dependencies:`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
Update Ubuntu installation documentation + bump required go version to 1.14 2020-06-10 08:24:38 +00:00			`- go (1.14 or higher)`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			`- gcc (7.4.0 or higher)`
			`- git (version 2 or higher)`
			`- bzr (some go dependency needs this)`
			`- jq`
			`- pkg-config`
			`- opencl-icd-loader`
			`- opencl driver (like nvidia-opencl on arch) (for GPU acceleration)`
			`- opencl-headers (build)`
			`- rustup (proofs build)`
			`- llvm (proofs build)`
			`- clang (proofs build)`

Update Ubuntu installation documentation + bump required go version to 1.14 2020-06-10 08:24:38 +00:00			`Install dependencies`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
Update Ubuntu installation documentation + bump required go version to 1.14 2020-06-10 08:24:38 +00:00			`sudo add-apt-repository ppa:longsleep/golang-backports`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			`sudo apt update`
Update Ubuntu installation documentation + bump required go version to 1.14 2020-06-10 08:24:38 +00:00			`sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git bzr jq pkg-config golang-go`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

Update Ubuntu installation documentation + bump required go version to 1.14 2020-06-10 08:24:38 +00:00			`Install Rust`
			`_(this is an interactive installer)_`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```sh
Update Ubuntu installation documentation + bump required go version to 1.14 2020-06-10 08:24:38 +00:00			`curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs \| sh`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

Update Ubuntu installation documentation + bump required go version to 1.14 2020-06-10 08:24:38 +00:00			`Clone the Lotus repository`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
			```sh
documentation: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +00:00			`git clone https://github.com/filecoin-project/lotus.git`
			`cd lotus/`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

Update Ubuntu installation documentation + bump required go version to 1.14 2020-06-10 08:24:38 +00:00			`Build the Lotus binaries from source and install`
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: current state of public documentation from https://docs.lotu.sh 2019-12-06 15:26:03 +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).
Update Ubuntu installation documentation + bump required go version to 1.14 2020-06-10 08:24:38 +00:00
			`### Interopnet`

			If you seek a smaller network to test, you can join the `interopnet`. Please note that this network is meant for developers - it resets much more often, and is much smaller. To join this network, checkout the branch `interopnet` instead of `master` before building and installing;
			```
			`git checkout interopnet`
			```

			`Please also note that this documentation (if viewed on the website) might not be up to date with the interopnet. For the latest documentation on the interopnet branch, see the [Lotus Documentation Interopnet Branch on GitHub](https://github.com/filecoin-project/lotus/tree/interopnet/documentation/en)`