Skip to content

Latest commit

 

History

History
71 lines (62 loc) · 4.07 KB

README.md

File metadata and controls

71 lines (62 loc) · 4.07 KB
Raw

Full configurable ARMv7/ARM64/AMD64 Monero-Node

build monero%20version Docker Pulls Docker Image Size (latest by date)

This docker image dockerizes a complete monero-node to use on ARMv7, ARM64 and AMD64 devices. It is fully configurable by overriding the containers' config file. By default, this container will run a standard full node.

How to run it with docker

The container can be started by simply running the following docker run command:

docker run -v ~/monero/chain:/data -v ~/monero/log:/log -v ~/monero/monerod.conf:/monerod.conf --name monerod -p 18080:18080 hvalev/monero-node:latest

or alternatively by using the following docker-compose configuration:

services:
  monerod:
    image: hvalev/monero-node:latest
    container_name: monerod
    ports:
    #monerod port
      - 18080:18080
    volumes:
      - ~/monero/chain:/data
      - ~/monero/log:/log
      #include only when you want to override the default config file
      #- ~/monero/monerod.conf:/monerod.conf

Configuring your monero node

The node can be tuned by overriding the containers' configuration file monerod.conf using one on the host machine. Various configuration settings can be set, e.g. running a pruned-/archive-node and others. For more information check the official monero configuration documentation or one of the many online resources.

Including a dashboard for your monero node

My other respository contains an automatic build for a monero-node dashboard which binds to the local RPC service and visualizes various details about your running node. The dashboard is created by jnbarlow and can be found in this repository. If you want to add the dashboard to your docker stack, use the following docker-compose file:

services:
  monerod:
    image: hvalev/monero-node:latest
    container_name: monerod
    ports:
    #monerod port
      - 18080:18080
    #monerod-gui port
      - 3000:3000
    volumes:
      - ~/monero/chain:/data
      - ~/monero/log:/log
      #include only when you want to override the default config file
      #- ~/monero/monerod.conf:/monerod.conf
  monerod-gui:
    image: hvalev/monero-dashboard:latest
    container_name: monerod-gui
    network_mode: service:monerod
    environment:
      - MONERO_HOST=0.0.0.0
      - MONERO_PORT=18081
      - TICKER=true
      - PORT=3000
    depends_on:
      - monerod

You can simply navigate to your host's IP:3000 to see the current status, connections to other nodes, database size and other information. The network_mode: service:monerod line essentially forces the GUI to run on the same network as the node container, allowing access to the nodes' localhost RPC service allowing seemless integration.

Notes

Be aware that fully syncing a node from scratch may take multiple days and is affected by your internet connection and disk I/O speed (i.e. using an SSD to store the chain is almost a prerequisite). It is also possible to bootstrap the node by preloading most of the chain as elaborated on here. In addition, the full chain as of time of writing is approximately 150GB. Running a pruned node could make the chain take significantly less space.

Acknowledgements

Naturally, all credit goes to the multiple contributors of the monero project as well as jnbarlow for creating the monero node dashboard.