lbry-docker/lbrynet/README.md

# lbrynet

## Compiler container

The [Dockerfile-linux-multiarch-compiler](Dockerfile-linux-multiarch-compiler) is for building lbrynet for any architecture supported
by an Ubuntu 18.04 base image.

### Register qemu to run docker images built for platforms other than your host

```
docker run --rm --privileged multiarch/qemu-user-static:register
```

### Build for the default x86_64 platform:

```
docker build -t lbrynet -f Dockerfile-linux-multiarch-compiler .
```

### Build for an ARM 32-bit platform:

```
docker build -t lbrynet-armhf -f Dockerfile-linux-multiarch-compiler --build-arg BASE_IMAGE=multiarch/ubuntu-core:armhf-bionic .
```

### Build for an ARM 64-bit platform:

```
docker build -t lbrynet-arm64 -f Dockerfile-linux-multiarch-compiler --build-arg BASE_IMAGE=multiarch/ubuntu-core:arm64-bionic .
```

### Extra build arguments

#### VERSION

Compile any version of lbrynet by specifying the git tag:

```
docker build -t lbrynet:v0.36.0 --build-arg VERSION=v0.36.0 -f Dockerfile-linux-multiarch-compiler .
```

### Running from the compiler container directly

The container requires a home directory to be mounted at `/home/lbrynet`. This
is to ensure that the wallet is backed up to a real storage device. You must run
the container with the appropriate volume argument, or else lbrynet will refuse
to run. 

If you compiled lbrynet as above, with the tag `lbrynet-x86`, you could run
docker like so:

```
docker run --rm -it -v wallet:/home/lbrynet lbrynet-x86 lbrynet start
```

This automatically creates a docker volume called `wallet` and it will persist
across container restarts. See more in the [Docker volume
documentation](https://docs.docker.com/storage/volumes/)