From Gentoo Wiki
Jump to:navigation Jump to:search

Monero is a privacy and security-focused cryptocurrency originating from the 2013 CryptoNote protocol.[1] It uses a combination of ring signatures[2] and zero-knowledge proofs to implement "Ring Confidential Transactions" (RingCT)[3] intended to obfuscate the sender, receiver, and amount of a transaction.[4]

As these privacy features prevent the use of Bitcoin's SPV (Simplified-Payment-Verification), it is necessary to distribute the software in two separate programs: the wallet and the node. The Wallet (Client) software has control over funds and is the minimum needed to make a private transaction and accept payments. The wallet connects to a Node (Server) that may run on the same computer or on another computer over the network. The Node connects to the peer-to-peer network, stores and relays transactions, and works together with with other computers on the network to come to a consensus about the order in which they occur.

Cryptocurrencies like Bitcoin use Proof-of-Work to make it difficult for an attacker to reverse the order of transactions (which would allow the attacker to spend funds more than once). Unlike Bitcoin, Monero uses a Proof-of-Work system which is designed to mitigate the effectiveness of specialized hardware (ASICs) as opposed to general-purpose CPUs[5]. Because of this, it becomes necessary to distribute Mining Software for everyday users that may wish to secure the network with their own hardware. This article discusses methods for mitigating cryptojacking attacks.

Most packages listed here are still on the GURU overlay. See this page for information on how to use GURU.


Feather Wallet

Currently still on GURU

Feather Wallet is a lightweight and simple Qt5/Qt6 implementation of the monero wallet.

Feather Wallet appearance
root #emerge --ask net-p2p/feather

By default, it's configured to connect to a remote node over the internet (and to onion sites if the tor daemon is running).

To connect feather wallet to a local node instead, select File>Settings>Network>Node>Add custom node(s) and add to the custom nodes list.


Currently still on GURU

The command-line wallet is packaged with net-p2p/monero:

root #emerge --ask net-p2p/monero

It can be summoned with:

user $monero-wallet-cli

Monero GUI

Monero GUI Appearance
Not packaged yet; try compiling from source or using .AppImage.

The official Monero GUI is not currently packaged in Gentoo, but is available as an executable .AppImage file from It includes monerod, monero-wallet-cli, and P2Pool within the same executable.



Currently still on GURU

monerod is the only "official" node implementation.


root #emerge --ask net-p2p/monero


Because monero's blockchain (the list of transactions, also called the "ledger") can take up quite a lot of space (about 107 GB as of 2023[6]) The two most important configuration settings are the directory in which it is stored (/var/lib/monero by default), and whether or not it should be "pruned". Pruning is an option that reduces storage usage by about 60%, storing an incomplete but usable copy of the blockchain[7]. Below is an example configuration file at /etc/monero/monerod.conf that changes both of these options:

FILE /etc/monero/monerod.confSetting blockchain directory and pruning

See monerod options and monerod.conf for a more complete list of configuration options


To start immediately:

root #rc-service monerod start

To start the monerod service on system boot, add it to the default runlevel:

root #rc-update add monerod default

To get monerod's current status:

user $monerod status

Mining Software

To incentivize users to secure the network with Proof-of-Work, 0.6 XMR is randomly rewarded every 2 minutes to a successful miner[8]. The average expected return can be calculated by multiplying the expected hashrate, dividing by the total network hashrate, then subtracting the total cost of electricity consumed. See the monero mining calculator. Generally speaking, Monero mining is not profitable without access to relatively modern CPUs and cheap electricity, or use of computers for indoor heating. GPU mining is also possible, but it is far less profitable compared to other cryptocurrencies.

While monerod does support mining by itself, it's recommended to use a faster mining implementation instead of monerod's built-in mining.


XMRig is the largest fast implementation of Monero mining. This gentoo package respects the opencl USE flag for AMD GPUs, however the use of Nvidia GPUs through CUDA requires a separate plugin.


USE flags for net-misc/xmrig RandomX, CryptoNight, KawPow, AstroBWT, and Argon2 CPU/GPU miner

donate Set the default donation level to 1% instead of 0
hwloc Use sys-apps/hwloc for CPU affinity support
opencl Enable OpenCL support (computation on GPU)
ssl Add support for SSL/TLS connections (Secure Socket Layer / Transport Layer Security)

root #emerge --ask net-misc/xmrig


If a monero node is running, (localhost on port 18081), solo mining is as simple as

user $xmrig -u YOUR_MONERO_ADDRESS

Another option is pool mining, which eliminates the need to run a monero node, and may offer more regular payouts at the cost of increased centralization and fees. Configuration depends on the pool, but usually looks something like:

user $xmrig -o -u YOUR_MONERO_ADDRESS


Disabling "hardware prefetchers" has been shown to increase mining performance by about 30%. This can be done by using the wrmsr command as shown in /usr/bin/ XMRig automatically runs this script when run as root.

Enabling "1GB huge pages" also yields a slight performance improvement on linux systems, at the cost of using more memory. This is done through the /usr/bin/ script.

See also the RandomX Optimization Guide


Currently still on GURU

P2Pool is a decentralized method of spreading out mining rewards into regular payouts, similar to a regular mining pool but with lower fees. The P2Pool software connects to a monero node and exposes a pool that miners such as XMRig can connect to.


root #emerge --ask net-p2p/p2pool


p2pool can be started in the current directory by running


Where MONERO_NODE_ADDRESS is the address of the monero node (for example, for a monero node that runs on the same computer), and YOUR_PRIMARY_ADDRESS is a monero primary address (begins with a "4" as opposed to a secondary address that begins with an "8") that will receive the mining reward. Once the P2Pool software finishes connecting to the network, one can start mining with XMRig as if it's a normal pool. By default, this is exposed on port 3333:

user $xmrig -o

There are currently two different networks: p2pool and p2pool-mini. If a computer has a lower hashrate, it may be better to connect to the p2pool-mini network instead by passing the --mini flag to p2pool:

user $p2pool --mini --host MONERO_NODE_ADDRESS --wallet YOUR_PRIMARY_ADDRESS

See also P2Pool FAQ


monerod can't sync

Sometimes monerod can get stuck if the computer is forcibly shutdown (for example, electrical outage or running out of battery). This can usually be fixed with monerod --db-salvage.

Cryptojacking Prevention

Cryptojacking is the act of hijacking a computer to mine cryptocurrency against the owner's will. Because of the CPU-bound nature of Monero's Proof-of-Work system (RandomX), it's easier for a hacker to capitalize on a victim's computing power relative to the rest of the network. However, RandomX also has some features designed to mitigate cryptojacking.

It is often speculated that a large portion of Monero's hashrate is a result of cryptojacked "IoT" devices (appliances such as cameras, toasters, etc. that contain computers which are unnecessarily connected to the internet). It is important to consider RandomX's Memory-hardness on low-end devices, which prevents it from running at all on computers with less than 256 MiB of memory, and massively decreases mining efficiency on devices with less than 2080 MiB.

Cryptojacking can often be used to extract additional money from a hacked VPS service at great cost to the client. One feature of RandomX is that efficient miners will necessarily leave a detectable trace in the state of CPU registers. "RandomX Sniffer" is a proof-of-concept tool that can be used to detect cryptojacking malware. In theory, VPS providers could use this method to warn clients or prevent cryptojacking though the use of Virtual Machine Introspection. If the client has a firewall installed, then they can also just monitor outbound connections to common Monero pools or to the P2Pool network.

Lastly, a common another attack vector is web mining (sometimes referred to as "Drive-by Mining"), which involves the insertion of mining scripts into webpages, taking advantage of the computers that access the web page. Web miners are particularly inefficient because of the decrease in branch prediction speeds and the lack of directed rounding support for floating point operations in JavaScript and WebAssembly. As such, web mining is typically orders of magnitude less efficient than mining natively. When hosting a web service, pay attention to securing the website against cross-site scripting attacks. As a user there is not much that can be done to avoid web mining besides installing an ad-blocker or disabling JavaScript altogether. Some browsers like Firefox have default settings to block common crypto mining scripts. It's also important to consider Web extensions as another vector for web mining.


Monero Ecosystem Contains some libraries for linking monero code to external C++, Java, Python, and Node.js Javascript projects. It also includes some example projects and learning materials.

Monero-rs is a similar monero library for the Rust programming language.

MoneroPy is a demonstration of some programming concepts in monero. See also MiniNero and the Zero to Monero tutorial.

External resources