Skip to content

Files

Latest commit

 

History

History
108 lines (72 loc) · 3.32 KB

README.md

File metadata and controls

108 lines (72 loc) · 3.32 KB

Unofficial containerized Hiveon ASIC Hub

This repository contains a Dockerfile to create a Docker image for Hiveon ASIC Hub on an Ubuntu 24.04 base. The image includes essential dependencies and sets up Hiveon ASIC Hub service.

Known issues

  • Issue: Migration files are not persistent.
    Cause: Updates
    Plausible solution: find and mount migration files alsong side /etc/asic-hub/.

Table of Contents

Prerequisites

Before building and running this Docker image, ensure you have the following installed:

Installation

  1. Clone the repository:

    git clone https://github.com/soudasuwa/hiveon-asic-hub.git
    cd hiveon-asic-hub
  2. Build the Docker image:

    docker build -t soudasuwa/hiveon-asic-hub:latest .

Usage

To run a container from the built image, use the following command:

docker run -d -p 8800:8800 --name asic-hub soudasuwa/hiveon-asic-hub:latest

This will start a container named asic-hub using the soudasuwa/hiveon-asic-hub:latest image.

There are 2 options to manage ASIC Hub:

  • Though web intereface accesible on port 8800.
  • Command line:
    docker exec asic-hub hubctl

Persistance

Configuration mount point: /etc/asic-hub/config.toml
Database mount point: /var/lib/asic-hub/data.db.

To apply changes, restart ASIC Hub service:

docker exec asic-hub systemctl restart asic-hub

Build Arguments

You can customize the build process using the following build arguments:

  • HUB_CHANNEL: The build channel, default: stable, other options: beta, testing.
  • HUB_BUILD: The build version, default: latest.
  • HUB_REPO_URL: The repository URL binary downloads, default: https://download.hiveos.farm/hub.
  • FARM_HASH: The HiveOS farm hash where to register deployed ASIC Hub.

Example usage of build arguments:

docker build --build-arg HUB_CHANNEL=stable --build-arg HUB_BUILD=latest --build-arg HUB_REPO_URL=https://download.hiveos.farm/hub --build-arg FARM_HASH=yourfarmhash40chars -t soudasuwa/hiveon-asic-hub:latest .

Contributing

Contributions are welcome! Please fork the repository and submit a pull request.

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature-branch).
  3. Make your changes.
  4. Commit your changes (git commit -am 'Add new feature').
  5. Push to the branch (git push origin feature-branch).
  6. Create a new pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.


For any issues or questions, please open an issue in this repository.