100 lines
2.9 KiB
Org Mode
100 lines
2.9 KiB
Org Mode
|
#+title: Monero Node Container
|
||
|
|
|
||
|
|
* About
|
||
|
|
|
||
|
|
This project builds images of [[https://github.com/monero-project/monero][Monero CLI]] for use as Podman or Docker containers.
|
||
|
|
|
||
|
|
#+begin_quote
|
||
|
|
The examples in this document use the ~podman~ command. Just swap with the ~docker~ command if you are using Docker.
|
||
|
|
#+end_quote
|
||
|
|
|
||
|
|
* Usage
|
||
|
|
|
||
|
|
#+begin_quote
|
||
|
|
*IMPORTANT:* It is recommended that you pin the image using the major version tags (ie. =0.17=, =0.18=). This way, a manual change is required before updating the service to the next major version. You can use this time to make backups in case something goes wrong.
|
||
|
|
#+end_quote
|
||
|
|
|
||
|
|
#+begin_quote
|
||
|
|
The =latest= tag always points to the latest version. So it has a higher chance of introducing a breaking change by accident. Only use =latest= if you like living on the edge.
|
||
|
|
#+end_quote
|
||
|
|
|
||
|
|
To run a container, use either ~podman run~ or define a service in a =compose.yaml= file.
|
||
|
|
|
||
|
|
** Run
|
||
|
|
|
||
|
|
To run with ~podman run~:
|
||
|
|
|
||
|
|
#+begin_src shell
|
||
|
|
podman run -v ./bitmonero:/home/monero/.bitmonero -v ./monero-wallet:/wallet -p 18080:18080 -p 18081:18081 -p 18089:18089 code.fosterhangdaan.com/foster/monero-node-container:0.18
|
||
|
|
#+end_src
|
||
|
|
|
||
|
|
** Compose
|
||
|
|
|
||
|
|
To define a service in a =compose.yaml= file:
|
||
|
|
|
||
|
|
#+begin_src yaml
|
||
|
|
version: "3.8"
|
||
|
|
|
||
|
|
services:
|
||
|
|
monero:
|
||
|
|
image: code.fosterhangdaan.com/foster/monero-node-container:0.18
|
||
|
|
container_name: monero
|
||
|
|
restart: unless-stopped
|
||
|
|
ports:
|
||
|
|
# Incoming peers
|
||
|
|
- "18080:18080"
|
||
|
|
# RPC
|
||
|
|
- "18081:18081"
|
||
|
|
# Restricted RPC
|
||
|
|
- "18089:18089"
|
||
|
|
volumes:
|
||
|
|
# Contains the blockchain
|
||
|
|
- ./bitmonero:/home/monero/.bitmonero
|
||
|
|
# Generate your wallet via accessing the container and run:
|
||
|
|
# cd /wallet
|
||
|
|
# monero-wallet-cli
|
||
|
|
- ./monero-wallet:/wallet
|
||
|
|
command:
|
||
|
|
- "--p2p-bind-ip=0.0.0.0"
|
||
|
|
- "--p2p-bind-port=18080"
|
||
|
|
- "--p2p-external-port=18080"
|
||
|
|
- "--rpc-bind-ip=0.0.0.0"
|
||
|
|
- "--rpc-bind-port=18081"
|
||
|
|
- "--rpc-restricted-bind-ip=0.0.0.0"
|
||
|
|
- "--rpc-restricted-bind-port=18089"
|
||
|
|
- "--non-interactive"
|
||
|
|
- "--confirm-external-bind"
|
||
|
|
- "--no-igd"
|
||
|
|
- "--public-node"
|
||
|
|
#+end_src
|
||
|
|
|
||
|
|
* Building
|
||
|
|
|
||
|
|
To build the image:
|
||
|
|
|
||
|
|
#+begin_src shell
|
||
|
|
podman build .
|
||
|
|
#+end_src
|
||
|
|
|
||
|
|
* Contributing
|
||
|
|
|
||
|
|
Please send patches and bug reports by email to one of the maintainers. See the *Core Maintainers* section for a list of contacts.
|
||
|
|
|
||
|
|
Refer to [[https://git-send-email.io][this guide]] if you are not familiar with sending Git patches over email.
|
||
|
|
|
||
|
|
* Core Maintainers
|
||
|
|
|
||
|
|
- *Foster Hangdaan*
|
||
|
|
- Website: [[https://www.fosterhangdaan.com][www.fosterhangdaan.com]]
|
||
|
|
- Email: [[mailto:foster@hangdaan.email][foster@hangdaan.email]]
|
||
|
|
- GPG Public Key: [[https://static.fosterhangdaan.com/foster-pubkey.asc][DBD3 8E38 4B9E 1F4F 19F9 5BAE E48D 7F49 A852 F112]]
|
||
|
|
- OpenAlias: =pay.fosterhangdaan.com=
|
||
|
|
|
||
|
|
* License
|
||
|
|
|
||
|
|
Licensed under the Apache License, Version 2.0. See =LICENSE.txt=.
|
||
|
|
|
||
|
|
* Copyright
|
||
|
|
|
||
|
|
Copyright 2023 Foster Hangdaan
|