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 apt update
sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git bzr jq pkg-config curl
sudo apt upgrade
```

### Install Go 1.14

Install the latest version of Go by following [the docs on their website](https://golang.org/doc/install).

### Clone the Lotus repository

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

### Build the Lotus binaries from source and install

! **If you are running an AMD platform or if your CPU supports SHA extensions you will want to build the Filecoin proofs natively**

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

#### Native Filecoin FFI building

```sh
env env RUSTFLAGS="-C target-cpu=native -g" FFI_BUILD_FROM_SOURCE=1 make clean deps 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://lotu.sh/en+join-testnet).
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)`

Add back installation of Go and Rust 2020-06-12 15:30:43 +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
			`sudo apt update`
Add back installation of Go and Rust 2020-06-12 15:30:43 +00:00			`sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git bzr jq pkg-config curl`
			`sudo apt upgrade`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00			```

Add back installation of Go and Rust 2020-06-12 15:30:43 +00:00			`### Install Go 1.14`

Remove Rust installation and remove Go installation guide 2020-06-16 13:30:41 +00:00			`Install the latest version of Go by following [the docs on their website](https://golang.org/doc/install).`
documentation: removes old docs folder, adds new documentation folder with organized content 2019-12-01 08:21:20 +00:00
Add back installation of Go and Rust 2020-06-12 15:30:43 +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			```

Add back installation of Go and Rust 2020-06-12 15:30:43 +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
Update docs and systemd scripts 2020-07-30 00:19:40 +00:00			`! If you are running an AMD platform or if your CPU supports SHA extensions you will want to build the Filecoin proofs natively`

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

Update docs and systemd scripts 2020-07-30 00:19:40 +00:00			`#### Native Filecoin FFI building`
Update Ubuntu installation documentation + bump required go version to 1.14 2020-06-10 08:24:38 +00:00
Update docs and systemd scripts 2020-07-30 00:19:40 +00:00			```sh
			`env env RUSTFLAGS="-C target-cpu=native -g" FFI_BUILD_FROM_SOURCE=1 make clean deps all`
			`sudo make install`
Update Ubuntu installation documentation + bump required go version to 1.14 2020-06-10 08:24:38 +00:00			```

Update docs and systemd scripts 2020-07-30 00:19:40 +00:00
Change docs.lotu.sh links to lotu.sh 2020-08-20 16:45:41 +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://lotu.sh/en+join-testnet).