go-ipfs-healthcheck

A plugin for kubo that serves a healthcheck endpoint which returns the status of the IPFS node.

Installation

This is a preloaded plugin built in-tree into go-ipfs when it's compiled.

git clone https://github.com/ipfs/kubo

cd kubo

# Pull in the plugin (you can specify a version other than "latest" if you'd like)
go get github.com/ceramicnetwork/go-ipfs-healthcheck/plugin@latest

# Add the plugin to the [preload list](https://github.com/ipfs/go-ipfs/blob/master/docs/plugins.md#preloaded-plugins)
echo "\nhealthcheck github.com/ceramicnetwork/go-ipfs-healthcheck/plugin 0" >> plugin/loader/preload_list

# Download dependencies
go mod download

# Build go-ipfs with the plugin
make build

# If an error occurs, try
go mod tidy
make build

Usage

Run Kubo IPFS node and check its status.

./cmd/ipfs/ipfs daemon
curl -X GET http://localhost:8011

Future work

• Use ipfs dag stat for healthcheck endpoint (See https://github.com/ipfs/go-ipfs/pull/8429/files)

Resources

Kubo Plugins

Maintainers

@v-stickykeys

License

Fully open source and dual-licensed under MIT and Apache 2.