fiftysix/dogecoin-core repository overview

⁠Fiftysix Dogecoin Core Docker Image

Maintainer: [email protected]⁠

⁠Overview

This Docker image provides a fully functional Dogecoin Core client built using the Fiftysix base image. It is designed to simplify running a Dogecoin node, offering secure and efficient participation in the Dogecoin network. Perfect for developers, blockchain enthusiasts, and institutions. The code can be viewed on the Fiftysix Github⁠.

⁠Tags

• latest: Points to the latest version of Dogecoin Core.
• <version>: Points to a specific version of Dogecoin Core. For example, 1.14.7.

⁠What is Dogecoin Core?

Dogecoin Core is the reference client that implements the Dogecoin protocol for remote procedure call (RPC) use. It is a secure and reliable way to interact with the Dogecoin network.

⁠Usage

⁠Basic Usage

To run a Dogecoin Core node:

docker pull fiftysix/dogecoin-core
docker run --name dogecoin-core -d fiftysix/dogecoin-core

⁠Directory Structure

In this Docker image, the following directories are used:

• Data Directory (/node/dogecoin-core/data): This is where Dogecoin Core stores the block data and other related files. Mounting this directory ensures blockchain data is persisted between container runs.
• Config Directory (/node/dogecoin-core/configs): This directory is used for storing configuration files for Dogecoin Core. You can provide your custom configuration file by mounting it to this directory and specifying it with the -conf flag.
• Scripts Directory (/node/dogecoin-core/scripts): This directory contains any scripts that you may want to execute as part of the Dogecoin Core startup or maintenance process. The entry point script (dogecoin-core-entrypoint.sh) is located here.

⁠Mounting Directories

You can mount host directories to the container’s data, config, and scripts directories to customize the behavior of the Dogecoin Core node.

Mounting the Data Directory: To persist Dogecoin Core data across container restarts, you can mount a host directory to the container's data directory:

docker run --name dogecoin-core -v /path/to/local/data:/node/dogecoin-core/data -d fiftysix/dogecoin-core

This command mounts the /path/to/local/data directory on your host to /node/dogecoin-core/data in the container, ensuring that blockchain data is preserved between container instances.

Mounting a Config File: To use a custom Dogecoin Core configuration file, mount your configuration file to the container’s config directory and specify it using the -conf flag:

docker run --name dogecoin-core -v /path/to/local/config.conf:/node/dogecoin-core/configs/your-config.conf -d fiftysix/dogecoin-core \
  -conf="/node/dogecoin-core/configs/your-config.conf"

This command mounts your custom config.conf file to the container’s config directory and instructs Dogecoin Core to use it.

Note, Dogecoin Core flags can be added on top of a configuration file to overwrite the setting.

Mounting the Scripts Directory: If you have custom scripts you want to include, you can mount them to the scripts directory. For example, to replace the entrypoint script:

docker run --name dogecoin-core -v /path/to/local/scripts:/node/dogecoin-core/scripts -d fiftysix/dogecoin-core

This command mounts your local scripts directory to /node/dogecoin-core/scripts in the container, allowing you to customize the startup behavior.

⁠Logging Dogecoin Core

docker logs dogecoin-core --tail 100

⁠Using Dogecoin RPC and REST Endpoints

⁠RPC Endpoint

The Dogecoin Core daemon (dogecoind) provides an RPC interface that allows you to interact with the Dogecoin network programmatically.

Start the Dogecoin Core daemon:

docker run --name dogecoin-core -d \
  -p 22555:22555 \
  -p 22556:22556 \
  fiftysix/dogecoin-core \
  -rpcallowip=0.0.0.0/0 \
  -rpcbind=0.0.0.0 \
  -rpcuser='user' \
  -rpcpassword='your_password'

Example RPC Query:

curl --user user:your_password --data-binary '{"jsonrpc":"1.0","id":"curltest","method":"getnetworkinfo","params":[]}' \
  -H 'content-type:text/plain;' http://127.0.0.1:22555/

⁠Docker Compose

Dogecoin Core can also be run using Docker Compose. An example compose file can be found on the Fiftysix Github⁠.

⁠Support

For support, please contact [email protected]⁠.

⁠About Fiftysix

Fiftysix is committed to making blockchain technology accessible, efficient, and reliable through robust decentralization. Learn more at fiftysix.xyz⁠.