nodevin

Nodevin

Nodevin allows anyone to run blockchain nodes effortlessly. It simplifies the process of setting up and managing nodes for various blockchains, ensuring they are always up-to-date with the latest software versions. With Nodevin, you can run nodes for Bitcoin, Litecoin, and more with ease.

Our goal is to facilitate blockchain node standup and maintenance for every chain in the world.

Features

• Easy Setup: Quickly set up blockchain nodes with a single command.
• Automatic Updates: The Nodevin daemon ensures your nodes are always running the latest software versions.
• Maximum Customization: Set unique ports, data storage, networking, images, or even run multiple nodes at once.
• Cross-Platform Support: Works on Linux, macOS, and Windows.

Installation

To get started with Nodevin, you need to have Docker and Docker Compose installed on your system. If you don't have them installed, Nodevin can help you set them up.

Prerequisites

• Docker 20+
• Docker Compose

Installation

Download the latest version of Nodevin from the releases page.

chmod +x nodevin
sudo mv nodevin /usr/local/bin/

Getting Started

1. Initialize Nodevin:

Run the following command to initialize Nodevin and check your system capabilities:

nodevin init

This command will check if you have the proper versions of Docker and Docker Compose installed. If not, it will prompt you to install them.

1. Start a Blockchain Node:

Once Nodevin is initialized, you can start a blockchain node. For example, to start a Bitcoin node, run:

nodevin start bitcoin

1. (Optional) - Advanced Features:

Nodevin allows for full customization in node startup. View the full list of flags for configuration details here. For example, this command runs a Bitcoin Testnet node with a specified command, docker image and tag (version), unique volume definitions, and more:

nodevin start bitcoin \
  --ord \
  --command="--rpcallowip=0.0.0.0/0 -rpcuser=user -rpcpassword=pass" \
  --testnet \
  --image=fiftysix/bitcoin-core \
  --version=27.0 \
  --container-name=bitcoin-node \
  --ports="8332:8332,8333:8333,18332:18332,18333:18333" \
  --volumes="bitcoin-core-data-2:/node/bitcoin-core" \
  --volume-definitions="bitcoin-core-data-2" \
  --volume-labels="nodevin.blockchain.software=bitcoin-core-testnet,remember-to-delete=yes" \
  --restart=always \
  --cpu-limit=2.0 \
  --mem-limit=1g \
  --cpu-reservation=1.0 \
  --mem-reservation=512m

Nodevin Daemon

The Nodevin daemon runs in the background and ensures your blockchain nodes are always up-to-date. It checks for updates every hour and automatically updates the nodes if a new version is available.

Starting the Daemon

To start the daemon, run:

nodevin daemon start

To start the daemon in detached mode (background):

nodevin daemon start -d

Stopping the Daemon

To stop the daemon, run:

nodevin daemon stop

Viewing Daemon Logs

To view the logs of the running daemon, run:

nodevin daemon logs

Commands

Here are some key commands you can use with Nodevin:

• nodevin init: Initialize Nodevin and check system capabilities.

• nodevin start <network>: Start a blockchain node (e.g., nodevin start bitcoin).

• nodevin stop <network>: Stop a running blockchain node.

• nodevin shell <network>: Open a shell to the running node container.

• nodevin logs <network>: View logs for a specific node.

• nodevin delete <volume-name-or-image-name>: Delete a Docker volume or image.

• nodevin request <network> --method <http-method> --params <json-data>: Make an RPC request to a blockchain network.

More documentation here.

Integrating Your Blockchain

Adding your blockchain to Nodevin requires a small one-time grant. For more information, visit https://nodevin.xyz/#/business.

Extra Features

For more features, such as:

• 90% faster sync times
• Universally available data snapshots
• Open source Docker images
• Docker image support and documentation

Visit https://nodevin.xyz/#/business.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request or open an Issue on GitHub.

License

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

Contact

Socials:

• Website
• Business
• Discord
• Twitter/X

This repository is maintaned by Fiftysix.

For any questions or suggestions, feel free to contact us at nodes@fiftysix.xyz.

Thank you for using Nodevin! Happy node running!