Skip to content

Build your personal docker-compose.yml file for Monero services.

Notifications You must be signed in to change notification settings

hundehausen/monero-suite

Repository files navigation

Monero Suite

...

This project lets you run a Monero node, P2Pool, and MoneroBlock in Docker containers. It also includes Tor for anonymity and Watchtower for auto-updating the containers. It lets you monitor the health of you Monero node and you can configure a reverse proxy to make the services reachable from the internet securely.

Features

  • monerod (the Monero daemon)
  • monero-wallet-rpc (the Monero wallet RPC - control a wallet with code)
  • P2Pool (a decentralized mining pool for Monero)
  • XMRig (an efficient Monero CPU miner - runs on the P2Pool node)
  • Traefik (a reverse proxy for other services, so they can be reached via a domain name)
  • MoneroBlock (a Monero block explorer)
  • Monitoring (a monitoring stack with Prometheus, Grafana, and monerod-exporter. It serves a beautiful dashboard with all stats of your node. And it even has a map with all nodes that are connected to your node.)
  • Tor Proxy and Tor Hidden Services (anonymity network for monerod, P2Pool and other services)
  • Docker Autoheal (auto-restart unhealthy containers)
  • Watchtower (auto-update containers)
  • Portainer (manage your docker services with a GUI in your browser)

Disclaimer: This project is not affiliated with, endorsed by, or sponsored by the Monero Project.

Quick Start (for Debian based systems) BETA

Still in Beta, use at your own risk.

  1. On the left side, select the service you want and configure them
  2. Generate a bash command with your installation script
  3. Verify the script via the preview button
  4. Copy that command and paste it into your terminal

Et voilà: Docker is installed and then all services will be started in the background.

Generated configs get deleted after 24 - 48 hours.

Pentested by Unkn8wn69

Manual Installation (for all systems)

You need to have Docker and Docker Compose installed. It could also work with Podman, but I haven't tested it.

Go to monersuite.org

Save the generated docker-compose.yml file to a directory and run the following command in that directory:

UID="$(id -u)" GID="$(id -g)" docker compose up -d

It will take some time to download the images and start the containers. You can check the status of the containers with:

docker compose ps

or a more interactive view with Portainer which is available in Monero Suite or LazyDocker which is a CLI tool.

If you are looking for the urls of the hidden services that were generated when starting the tor container for the first time, you can find them in the container logs:

docker compose logs tor

Roadmap

no particular order

Donations

If you find this project useful, please consider donating to the following address:

87cQNxrM3oWVkZ8TRWUHi9LmvruKgQSA7AxqoqJDr7n1PgGcZkXhAToVz3rEWxjAMj7caKCcqjYfDSFeLey1Sf4hUF3gmNn