Skip to content

Latest commit

 

History

History

plugins

README.md

Plugins for Coinboot

Coinboot is a framework for diskless computing.
This repository contains plugins for Coinboot which expand Coinboot with further software and functionalities.
It also contains coinbootmaker - a little helper to build your own Coinboot plugins.

For more information how to boot your machines with Coinboot visit: https://coinboot.io

Coinboot Plugins

Plugin Version Kernel Description Maintainer Source URL
AMDGPU-Pro Polaris 20.50-1234664 AMD Polaris GPU (RX500/RX400 family) firmware and driver with support for OpenCL 1.2 Gunter Miegel [email protected] https://www.amd.com/en/support/kb/release-notes/rn-amdgpu-unified-linux-20-50 https://s3.eu-central-1.wasabisys.com/coinboot/5.4.0-58-generic/coinboot_amdgpupro_polaris_20.50-1234664_20210815.1628.tar.gz
ethminer v0.18.0 Ethereum miner with OpenCL, CUDA and stratum support Gunter Miegel [email protected] https://github.com/ethereum-mining/ethminer https://s3.eu-central-1.wasabisys.com/coinboot/all/coinboot_ethminer_v0.18.0_20210815.1630.tar.gz
ethminer v0.18.0 all Ethereum miner with OpenCL, CUDA and stratum support Gunter Miegel [email protected] https://github.com/ethereum-mining/ethminer https://s3.eu-central-1.wasabisys.com/coinboot/all/coinboot_ethminer_v0.18.0_20220119.0738.tar.gz
ethminer v0.18.0 all Ethereum miner with OpenCL, CUDA and stratum support Gunter Miegel [email protected] https://github.com/ethereum-mining/ethminer https://s3.eu-central-1.wasabisys.com/coinboot/all/coinboot_ethminer_v0.18.0_20220119.0739.tar.gz
Team Red Miner v0.8.3 This is an optimized miner for AMD GPUs created by todxx and kerney666 Gunter Miegel [email protected] https://github.com/todxx/teamredminer https://s3.eu-central-1.wasabisys.com/coinboot/all/coinboot_teamredminer_v0.8.3_20210815.1630.tar.gz
Telegraf v1.18.1 The plugin-driven server agent for collecting & reporting metrics. Gunter Miegel [email protected] https://github.com/influxdata/telegraf https://s3.eu-central-1.wasabisys.com/coinboot/all/coinboot_telegraf_v1.18.1_20210815.1632.tar.gz
Telegraf v1.21.1 The plugin-driven server agent for collecting & reporting metrics. Gunter Miegel [email protected] https://github.com/influxdata/telegraf https://s3.eu-central-1.wasabisys.com/coinboot/all/coinboot_telegraf_v1.21.1_20211228.1329.tar.gz

Requirements

  • Coinboot with kernel 5.4.0-58-generic

If you want to build plugins on your own:

  • Docker

  • a Debian or Ubuntu build host

  • brctl which is part of the bridge-utils package

Usage

Pre-built Plugins

Put the pre-built plugins of your choice that your can download under releases into the plugins directory of your Coinboot setup.

Coinbootmaker - build the Plugins

To build Coinboot plugins on your own use coinbootmaker.

Usage: coinbootmaker [-i] [-l] [-h] [-p <plugin name> <path to initramfs>]

-i              Interactive mode - opens a shell in the build environment
-p <file name>  Plugin to build
-l              List plugins available to build
-h              Display this help

For example:

$ ./coinbootmaker -p ethminer /tmp/coinboot-initramfs-4.15.0-43-generic

coinbootmaker takes a path to a Coinboot-Initramfs to create an environment for building the plugins
by converting the given Initramfs into a Container image and run it.
The plugin creation script located at src is executed in that coinbootmaker container and the resulting
plugin archive is written to the build directory.

Run coinbootmaker interactivly (-i)

For developing and debugging

$ ./coinbootmaker -i /tmp/coinboot-initramfs-4.15.0-43-generic

  • You are entering the build environment

  • Execute $ create_plugin.py start

  • Do your changes to the system - e.g. install packages and edit configuration files.

  • When your are done: Execute $ create_plugin.py finish <name-of-your-plugin>

  • Place the created plugin archive into ./plugins on the host where you run the Coinboot Docker container

Up on the next boot the changes your made in your plugin are ready to be used on your Coinboot machines!

Creation of plugins can also be scripted. Just do whatever you want to do between the lines $ create_plugin.py start and $ create_plugin.py finish <name-of-your-plugin>.

License

MIT

Please notice even while the scripts to create Coinboot plugins are licensed with the MIT license the software packaged by this scripts may be licensed by an other license with different terms and conditions.
You have to agree to the license of the packaged software to use it.

Author

Gunter Miegel [email protected]

Contribution

Fork this repo. Make a pull request to this repo.