/filecoin-docker

A Docker image for Lotus Filecoin nodes

Primary LanguageShellApache License 2.0Apache-2.0

filecoin-docker

CircleCI

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.

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

License

This project is licensed under the Apache 2.0 license.