feather/BUILDING.md

189 lines
5 KiB
Markdown
Raw Normal View History

2021-08-29 18:07:19 +00:00
## Building with Docker
2021-08-29 18:07:19 +00:00
Builds with Docker are done in 3 steps:
1. Cloning this repository (+submodules)
2021-08-29 18:07:19 +00:00
2. Creating a base image containing the build environment
3. Building Feather using the base image
2021-08-28 18:50:13 +00:00
### Linux x86-64 (reproducible)
2021-08-29 18:07:19 +00:00
The instructions in this section are for 64-bit AMD/Intel processors. For ARM64 platforms see the next section.
Binaries produced in this section are reproducible and their digests should match those of release binaries.
#### 1. Clone
2021-11-02 16:17:28 +00:00
Replace `master` with the desired version tag (e.g. `1.0.1`) to build the release binary.
2021-08-29 18:07:19 +00:00
```bash
2022-02-03 14:19:50 +00:00
git clone https://github.com/feather-wallet/feather.git
cd feather
2021-08-29 18:07:19 +00:00
git checkout master
git submodule update --init --recursive
```
2020-12-10 17:13:18 +00:00
#### 2. Base image
```bash
2021-08-29 18:07:19 +00:00
docker build -t feather:linux -f Dockerfile.linux --build-arg THREADS=8 .
```
2021-07-09 09:50:24 +00:00
Building the base image takes a while. You only need to build the base image once per release.
#### 3. Build
2021-08-29 18:07:19 +00:00
##### Standalone static binary
If you're re-running a build make sure to `rm -rf build/` first.
2021-01-15 21:04:53 +00:00
```bash
2021-07-09 09:50:24 +00:00
docker run --rm -it -v $PWD:/feather -w /feather feather:linux sh -c 'WITH_SCANNER=Off make release-static -j8'
```
2021-08-29 18:07:19 +00:00
The resulting binary can be found in `./build/bin/`.
2021-01-15 21:04:53 +00:00
##### AppImage
```bash
2021-07-09 09:50:24 +00:00
rm -rf build
docker run --rm -it -v $PWD:/feather -w /feather feather:linux sh -c 'make release-static -j8'
2021-05-22 19:53:42 +00:00
docker run --rm -it -v $PWD:/feather -w /feather/build feather:linux ../contrib/build-appimage.sh
2021-01-15 21:04:53 +00:00
```
2021-05-22 19:53:42 +00:00
The resulting AppImage will be located in `./build`.
2021-08-29 18:07:19 +00:00
### Linux ARM64 (reproducible)
This section describes how to build Feather for ARM64 based platforms (including Raspberry Pi 3 and later, running 64-bit Rasbian).
Binaries produced in this section are not yet reproducible.
2021-08-28 18:50:13 +00:00
#### 1. Clone
2021-11-02 16:17:28 +00:00
Replace `master` with the desired version tag (e.g. `1.0.1`) to build the release binary.
2021-08-29 18:07:19 +00:00
2021-08-28 18:50:13 +00:00
```bash
2022-02-03 14:19:50 +00:00
git clone https://github.com/feather-wallet/feather.git
2021-08-28 18:50:13 +00:00
cd feather
git checkout master
git submodule update --init --recursive
```
#### 2. Base image
```bash
2021-08-29 18:07:19 +00:00
docker build --tag feather:linux-arm64 --platform linux/arm64 -f Dockerfile.linux --build-arg THREADS=8 .
2021-08-28 18:50:13 +00:00
```
Building the base image takes a while (especially when emulated on x86-64). You only need to build the base image once per release.
#### 3. Build
2021-08-29 18:07:19 +00:00
##### Standalone static binary
2021-08-28 18:50:13 +00:00
```bash
docker run --platform linux/arm64/v8 --rm -it -v $PWD:/feather -w /feather feather:linux-arm64 sh -c 'WITH_SCANNER=Off make release-static-linux-arm64 -j8'
```
Note: If you intend to run Feather on a Raspberry Pi or any device without AES hardware acceleration, use the following command instead:
```bash
docker run --platform linux/arm64/v8 --rm -it -v $PWD:/feather -w /feather feather:linux-arm64 sh -c 'WITH_SCANNER=Off make release-static-linux-arm64-rpi -j8'
```
2021-08-29 18:07:19 +00:00
The resulting binary can be found in `./build/bin/`.
2021-08-28 18:50:13 +00:00
2021-08-29 22:09:11 +00:00
##### AppImage
##### ARMv8-a (with AES hardware acceleration)
```bash
rm -rf build
docker run --rm -it -v $PWD:/feather --platform linux/arm64/v8 -w /feather feather:linux-arm64 sh -c 'make release-static-linux-arm64 -j8'
docker run --rm -it -v $PWD:/feather --platform linux/arm64/v8 -w /feather/build feather:linux-arm64 ../contrib/build-appimage-arm64.sh
```
##### Raspberry Pi
```bash
rm -rf build
docker run --rm -it -v $PWD:/feather --platform linux/arm64/v8 -w /feather feather:linux-arm64 sh -c 'make release-static-linux-arm64-rpi -j8'
docker run --rm -it -v $PWD:/feather --platform linux/arm64/v8 -w /feather/build feather:linux-arm64 ../contrib/build-appimage-arm64.sh
```
The resulting AppImage will be located in `./build`.
2021-01-10 23:40:17 +00:00
### Windows (reproducible)
#### 1. Clone
```bash
2022-02-03 14:19:50 +00:00
git clone --branch master --recursive https://github.com/feather-wallet/feather.git
cd feather
```
2021-11-02 16:17:28 +00:00
Replace `master` with the desired version tag (e.g. `1.0.1`) to build the release binary.
2021-01-10 23:40:17 +00:00
#### 2. Base image
```bash
2021-01-10 23:40:17 +00:00
docker build -f Dockerfile.windows --tag feather:win --build-arg THREADS=4 .
```
2021-01-10 23:40:17 +00:00
Building the base image takes a while. You only need to build the base image once.
#### 3. Build
```bash
2022-02-23 16:04:23 +00:00
docker run --rm -it -v $PWD:/feather -w /feather feather:win sh -c 'make release-static-windows root=/depends target=x86_64-w64-mingw32 tag=win-x64 -j4'
```
2021-01-10 23:40:17 +00:00
If you're re-running a build make sure to `rm -rf build/` first.
2021-08-29 18:07:19 +00:00
The resulting binary can be found in `./build/x86_64-w64-mingw32/release/bin/`.
---
2021-08-29 18:07:19 +00:00
## Building on macOS
2021-08-28 18:50:13 +00:00
For macOS it's easiest to leverage [brew](https://brew.sh) to install the required dependencies.
```bash
2022-05-26 12:39:46 +00:00
brew install qt libsodium libzip qrencode unbound cmake boost hidapi openssl expat libunwind-headers protobuf pkgconfig zbar
```
2022-05-26 12:39:46 +00:00
Build and install Polyseed:
```bash
git clone https://github.com/tevador/polyseed.git
cd polyseed
mkdir build
cd build
cmake ..
make
sudo make install
```
Clone the Feather repository.
```bash
2022-02-03 14:19:50 +00:00
git clone --recursive https://github.com/feather-wallet/feather.git
2022-05-26 12:39:46 +00:00
cd feather
```
Build Feather.
```bash
2022-05-26 12:39:46 +00:00
make mac-release
```
2021-08-28 18:50:13 +00:00
The resulting macOS application can be found `build/bin/feather.app` and will **not** have Tor embedded.
2022-05-26 12:39:46 +00:00
To run a Tor daemon on macOS:
```bash
brew install tor
brew services restart tor
```