openworklabs/lotus repository overview

⁠filecoin-docker

A Docker image for Lotus⁠ Filecoin nodes.

⁠Getting Started

These instructions will cover usage information and for the docker container

⁠Prerequisities

In order to run this container you'll need docker installed.

• Windows⁠
• OS X⁠
• Linux⁠

⁠Usage

## Build the Docker image
make build
## Run the Docker container
make run

Verify that the container is running successfully with:

docker ps

⁠Environment Variables

• BRANCH - The git release, tag or branch
• LOTUS_EXPORT - Set to true if you want to export chain snapshots on a daily basis somewhere
• LOTUS_EXPORT_PATH - If LOTUS_EXPORT is set to true - specify whether .car file should be saved
• SHEDEXPORT - Set to true if you want to export chain snapshots using lotus-shed
• SHEDEXPORTPERIOD - Defines period of chain snapshotting. Examples: 1m, 1h, 1d
• SHEDEXPORTPATH - Defines path where to export chain snapshot

⁠Volumes

• /root/.lotus - lotus main folder

⁠Useful File Locations

• /scripts/entrypoint - Docker entrypoint script

⁠Dependencies

• ubuntu:18.04
• golang:1.13
• git
• mesa-opencl-icd
• ocl-icd-opencl-dev
• gcc
• bzr
• jq
• Lotus

⁠Automatic build in docker hub

If you want to start automatic build in Docker Hub, you have to:

• change variable ARG BRANCH in Dockerfile, push changes, create new tag, push tag to repository

or

• change variable ARG BRANCH in Dockerfile, BRANCH in Makefile and execute make git-push

If you want run build manually from master branch, you have to change variable ARG BRANCH in Dockerfile push to repository, start build on Docker Hub web page.

Example:

git commit -a -m "ntwk-butterfly-7.10.0" && git push && \
git tag ntwk-butterfly-7.10.0 && git push --tags

List of tag you may find in lotus repository⁠

It works with next tags:

• v*
• ntwk-*

New version is available in Docker Hub⁠

⁠Find Us

• Website⁠
• GitHub⁠
• Docker Hub⁠

⁠License

This project is licensed under the Apache 2.0⁠ license.