Monero/Manual Instructions

From Whonix
Jump to navigation Jump to search
Monero
Monero Logo

Info This information is now out of date. Refer to the main Monero chapter instead.

What is Monero?[edit]

Monero is a private-centric cryptocurrency launched in 2014 to allow direct and anonymous digital payments without being dependent on a central authority.

Installation[edit]

Apart from these hints, installing Monero in Whonix does not differ from installing Monero on any Linux based distribution.

Advanced Qubes users could look into CLI Wallet/Daemon Isolation with Qubes + Whonixarchive.org [1] - untested by Whonix developers.

[2]

  1. Use Tor Browser, go to the Monero download page https://getmonero.org/downloads/archive.org and download it. [3] [4] [5]
  2. Download Monero for Linux 64-bit. [6]
  3. Always verify signatures! -- to verify the integrity of the file you downloaded please follow this official guidearchive.org on the official Monero website.
  4. Open the folder containing the Monero .tar.bz2 file.
  5. Right-click and choose Open Terminal Here.
  6. Type tar xvf into your terminal window followed by the name of the file that you downloaded. An example is provided below.

tar xvf monero-gui-linux-x64-v0.14.0.0.tar.bz2

Your terminal window will list the contents as they are being extracted. Once completed you can continue on to the next section.

Start Monero GUI[edit]

Open the extracted Monero folder then right-click and choose Open Terminal Here.

Alternatively you can use cd in terminal to enter the Monero directory; see the example below.

cd /home/user/Downloads/Applications/monero-gui-v0.14.0.0

Now type the following code into your terminal window.

./start-gui.sh

Add Monero Desktop Launcher[edit]

  1. Right-click on the desktop and choose Create Launcher.
  2. In the "Name:" field type Monero GUI.
  3. In the "Command:" field type the path leading to your extracted Monero folder followed by start-gui.sh. For example: /home/user/Downloads/monero-gui-v0.14.0.0/start-gui.sh

To add an icon to the desktop link, follow these steps:

  1. Visit https://getmonero.org/press-kit/symbols/monero-symbol-on-white-480.pngarchive.org and save the image to your downloads.
  2. When creating your launcher click No icon. Choose Image Files from the "Select icon from:" drop down.
  3. Now open the folder where the Monero .png image is located, select the file and choose OK.
  4. After clicking Create a .desktop file will be added to the desktop.

Installation with a Remote Node[edit]

Using a remote node provides a quick way to set up your Monero wallet. You will not have to download the entire blockchain.

It is important to note that the remote node:

  • Cannot spend your XMR (you hold the keys).
  • Does not know your IP address (we are connecting to it over Tor).
  • Does not know your XMR address.
  • Does not know your balance or private view key.

However, using a remote node is not without risk, you can read about the possible attacks here: https://moneroworld.com/archive.org

In general, if the wallet warns you about the node misbehaving exit the wallet and connect to a different node.

CLI Instructions[edit]

Download the Wallet[edit]

1. Navigate to https://getmonero.org/downloadsarchive.org

  • Download the Linux, 64-bit (Command-line Tools Only) version.
  • Save the file in Browser > Downloads.

2. Open the file explorer (Thunar).

  • Wait for the download to complete.
  • Downloads buttonOpen Containing Folder.

3. Right-click the archive you just downloaded.

  • Click ExtractExtract Archive Here.
  • After extraction a folder named monero-v0.14.0.0 should appear.

4. Copy this folder to your Home directory (/home/user/).

  • In this sidebar under 'Places' click 'Home'.
  • Right-clickPaste One Folder.
  • If the option to paste is greyed out you're probably in /home/ instead of /home/user/.

Create a Desktop Shortcut[edit]

1. Click on the hamburger menu.

  • Top left corner of the screenConfigure Desktop.
  • Move Tor Browser out of the way if it is not visible.

2. Navigate to the 'Wallpaper' section.

  • Change 'Layout' to 'Folder View', then click Apply.
  • Icons should now appear on the desktop.

3. Open the terminal.

  • Double-click on Konsole on the desktop.

4. Copy and paste the following terminal command and press Enter.

printf "[Desktop Entry]\nComment=Start Monero wallet\nExec=~/monero-v0.14.0.0/monero-wallet-cli --daemon-host xmrtolujkxnlinre.onion:18081\nPath=~/monero-v0.14.0.0/\nTerminal=true\nType=Application\nName=Monero CLI" > ~/Desktop/MoneroCLI.desktop && chmod +x ~/Desktop/MoneroCLI.desktop

A shortcut named Monero CLI should now appear on the desktop.

The terminal can now be closed.

Set up the Wallet[edit]

1. Double-click the desktop shortcut.

  • A terminal window will now appear.

2. Type a name for your wallet (for example 'monero'; remember this) and press Enter.

3. Confirm the creation of a new wallet.

  • Type 'Y' and press Enter.

4. Enter a password and confirm the password.

5. Select the desired language for your 25 word seed.

  • For English, press '1' followed by Enter.
  • If the process is stuck after pressing Enter, your node is down. Scroll down to troubleshooting for instructions on how to resolve this.

6. Write down your 25 word seed and optionally the current block height (this can be found herearchive.org).

  • If you fail to do this and something happens to your Whonix install your Monero are gone forever.
  • You can use this seed to recover your wallet.
  • The wallet creation height can be used to restore the wallet from the seed faster.

7. The wallet will now refresh and this can take a couple of minutes.

  • If you get "Error: refresh failed: no connection to daemon": your node is down. Scroll down to troubleshooting for instruction on how to resolve this.

Congratulations, your CLI wallet is now set-up!

Common Commands[edit]

Table: Common Monero Commands

Command Terminal
Full Command List help
Show your Balance balance
View your Primary Address address
Create a New Subaddress address new <label>
View all (Sub)addresses address all
Create a New Transaction transfer <address> <amount>
Show all transfers show_transfers

Incoming transactions will automatically show up in the CLI.

It takes 10 blocks (~20 minutes) before your balance unlocks after receiving a tx. You will know how much of the balance is spendable by typing balance and looking for the unlocked balance.

Subsequent Whonix Boot[edit]

When Whonix is rebooted, double-click the Monero CLI shortcut on your desktop.

Enter your wallet name and password, and allow the wallet to refresh.

CLI Troubleshooting[edit]

To change the remote node:

  1. Close the wallet if it is open.
  2. Right-click the desktop shortcutOpen WithKWrite
  3. Replace the daemon host (for example zdhkwneu7lfaum2p.onion:18099) with a different one from the list below. Make sure to also copy the correct port.
  4. Save the file and restart your wallet with the shortcut -- it should start syncing again.

xmrtolujkxnlinre.onion:18081 xmkwypann4ly64gh.onion:18081 mmp26upm3gig2ltk.onion:18089 xmrag4hf5xlabmob.onion:18081 monerospv4fuwduf.onion:18081 7245ifq4iw3uvexs.onion:18081 zdhkwneu7lfaum2p.onion:18099

GUI Instructions[edit]

Download the Wallet[edit]

1. Navigate to https://getmonero.org/downloadsarchive.org

  • Download the Linux, 64-bit version.
  • Save the file in Browser > Downloads.

2. Open the file explorer (Thunar).

  • Wait for the download to complete.
  • Downloads buttonOpen Containing Folder.

3. Right-click the archive you just downloaded and click copy.

  • Open terminal and type tar -xjvf
  • Press Ctrl + Shift + V to paste your file path. It should look like this: tar -xjvf /home/user/.tb/tor-browser/Browser/Downloads/monero-gui-linux-x64-v0.14.0.0.tar.bz2
  • Press Enter.
  • After extraction a folder named monero-gui-v0.14.0.0 should appear.

4. Copy this folder to your Home directory (/home/user/).

  • In the sidebar under Places, click Home.
  • Right-clickPaste One Folder.
  • If the option to paste is greyed out you are probably in /home/ instead of /home/user/.

Create a Desktop Shortcut[edit]

1. Click on the hamburger menu.

  • Top left corner of the screenConfigure Desktop.
  • Move Tor Browser out of the way if it is not visible.

2. Navigate to the 'Wallpaper' section.

  • Change 'Layout' to 'Folder View', then click Apply.
  • Icons should now appear on the desktop.

3. Open the terminal.

  • Double-click on Konsole on the desktop.

4. Copy and paste the following in the terminal and press Enter.

printf "[Desktop Entry]\nComment=Start Monero wallet\nExec=~/monero-gui-v0.14.0.0/start-gui.sh \nPath=~/monero-gui-v0.14.0.0/\nTerminal=true\nType=Application\nName=Monero GUI" > ~/Desktop/MoneroGUI.desktop && chmod +x ~/Desktop/MoneroGUI.desktop

A shortcut named 'Monero GUI' should now appear on the desktop.

The terminal can now be closed.

Set up the Wallet[edit]

1. Double-click the desktop shortcut.

  • A terminal window will now appear, followed by the GUI.

2. Select your language, then click continue.

3. Choose 'Advanced mode'.

4. Choose 'Create a new wallet'.

5. Write down your 25 word seed and optionally the current block height (this can be found herearchive.org).

  • If you fail to do this and something happens to your Whonix install your Monero are gone forever.
  • You can use this seed to recover your wallet.
  • The wallet creation height can be used to restore the wallet from the seed faster.

6. Enter a password.

7. Click 'Connect to a remote node' and fill in remote node details.

  • Remote Node Hostname / IP: xmrtolujkxnlinre.onion
  • Port: 18081

8. Click on 'Use Monero'.

9. Check your wallet starts synchronizing; this can take a couple of minutes to finish.

  • If you get "Failed to fetch remote nodes from third-party server", this means the node is down. See the troubleshooting section below for steps to resolve the problem.

Congratulations, your Monero GUI wallet is now set-up!

Common Actions[edit]

To create a new subaddress: ReceiveCreate new address

To send a transaction: Go to send, fill in the amount and address.

Subsequent Whonix Boot[edit]
  1. Double-click the 'Monero GUI' desktop shortcut.
  2. Enter your password.
  3. Allow the wallet to synchronize.
GUI Troubleshooting[edit]

Changing the remote node

1. Close your Monero GUI wallet.

2. Choose a node from the list below.

xmrtolujkxnlinre.onion:18081 xmkwypann4ly64gh.onion:18081 mmp26upm3gig2ltk.onion:18089 xmrag4hf5xlabmob.onion:18081 monerospv4fuwduf.onion:18081 7245ifq4iw3uvexs.onion:18081 zdhkwneu7lfaum2p.onion:18099

3. Open the terminal.

  • Double-click Konsole on the desktop.

4. Type the following command in the terminal.

sed -i 's/remoteNodeAddress=.*/remoteNodeAddress=REMOTENODE/g' ~/.config/monero-project/monero-core.conf

Substitute REMOTENODE for the node you have chosen from the list of remote nodes. Do not forget to include the numbers at the end.

5. Start your wallet.

It should now start synchronizing. If it doesn't, repeat these steps with a different remote node.

Restoring a wallet from file

  1. Click 'Open a wallet from file'.
  2. Navigate to and select your <walletname>.keys file.
  3. Enter the password associated with that wallet.
  4. If your client gives an error, then close and restart your wallet. It should work now, if not, try restoring from seed.
  5. Continue with step 6 of Setting up the wallet.

Restoring a wallet from the 25 word seed

  1. Click 'Restore wallet from keys or mnemonic seed'.
  2. Enter your 25 word seed.
  3. Enter your wallet creation height / restore height (if unsure, see below).
  4. Continue with step 5 of Setting up the wallet.

Calculating the wallet creation height'

  • Take the current height from https://moneroblocks.infoarchive.org and subtract (720 * the number of days since you created the wallet). It does not have to be exactly right, but should at least be before the the first transaction to your wallet. Use this value as your restore height.

Large number of blocks remaining after restoring from seed

  • You probably forgot to enter the restore height. To fix this go to Settings, scroll down to Debug info. Click to change wallet creation height and enter your wallet creation height, then save. You may need to reopen the wallet to have it detect this.

Forum Discussion[edit]

Donations[edit]

After having installed monero, please consider making a donation to Whonix to help keep it running for many years to come.

Donate Monero (XMR) to Whonix.

84ZZSsqyh5niztCgxmWAejDLu9eDerWo4Wsx8woEhDGpdKP3BWPtqenNjKuv8vojrB968U3hqYTKgLGt2zEcGopX1qaEPew

Architecture[edit]

Monero works by having contributors host large files which are equivalent to a public ledger. Any time someone broadcasts a transaction, every ledger maintainer updates their copy of the ledger and ensures no cheating or fraud has occurred. As with most cryptocurrencies, transactions are sent to Public Addresses which are derived from personally created private keys.

Since transactions could otherwise be traced by watching which addresses are sending to each-other, Monero uses a Diffie-Hellman key exchange using the transaction information on the sender's side and the public address on the receiver's end of a transaction to encrypt the recipients address on the ledger. To protect the sender, spending Monero is equivalent to forwarding the output of the previous transaction, so a users address is never stored on the ledger at all - this technique is called Stealth Addressing.

Since this solution is imperfect, and allows EABE attacks and is dependent on ECC for the key exchange, Monero uses a second layer of anonymity called Ring Signatures. When signing a transaction and broadcasting it to the network, Ring Signatures take signers from previous transactions and forge a new signature with Ring Size = N, where you cannot tell which entity in the group N actually authorized a transaction. This further obfuscates the blockchain and reduces the available attack vectors on the cryptocurrency as a whole, as well as introduces several zero knowledge proofs which prevent absolute analysis of the ledger.

Ring Signatures combined with Stealth Addressing prevent many attack vectors, but since new transactions are forwarded outputs from previous ones you can still perform analysis by viewing the amounts spent on-chain. To address this potential issue, a solution called RingCT was introduced which obfuscates the amount spent in a transaction.

Further attack vectors including cross-referencing an address posted in multiple places and IP leaks when connecting to the network are further developments sought out by the Monero community. These potential issues are addressed with Subaddresses and Kovri respectively.

See Also[edit]

It is recommended to read the Money wiki page as it contains a lot of related information on how to make anonymous payments.

Footnotes[edit]

  1. qubes-users - Guide: Monero wallet/daemon isolation w/qubes+whonixarchive.org
  2. Only monero is currently available from Debian sid. Monero GUI is not yet available from packages.debian.org.

    Prior to installing moneroarchive.org from Debian unstable read Install software from Debian unstable to understand the risks involved and circumvention options. Mixing packages from Debian stable with later release packages like Debian unstable can lead to instability.

    1. Open a terminal.

    If you are using Qubes-Whonix, complete the following steps.

    Qubes App Launcher (blue/grey "Q")Whonix-Workstation App Qube (commonly named anon-whonix)Xfce Terminal

    If you are using a graphical Whonix with Xfce, run.

    Start MenuXfce Terminal

    2. In Whonix-Workstation (whonix-workstation-17 Qubes-Whonix) konsole, add Debian stable codename bookworm to the apt-conf default-release.

    sudo su -c "echo -e 'APT::Default-Release bookworm;' > /etc/apt/apt.conf.d/70defaultrelease"

    3. Add the current Debian unstable codename sid to sources.list.d.

    sudo su -c "echo -e 'deb https://deb.debian.net/debian sid main' > /etc/apt/sources.list.d/unstable.list"

    Or alternatively use the .onion mirror.

    sudo su -c "echo -e 'deb tor+http://2s4yqjx5ul6okpp3f2gaunr2syex5jgbfpfvhxxbbjwnrsvbk5v3qbid.onion/debian sid main' > /etc/apt/sources.list.d/unstable.list"

    4. Update the package lists.

    sudo apt update

    5. Install monero from the current Debian unstable codename sid repository.

    sudo apt install monero/sid

    6. Undo.

    On occasion it is necessary to undo this configuration, for example when upgrading from Debian bookworm to trixie. To proceed, run.

    Delete Debian testing repository list.

    sudo rm /etc/apt/sources.list.d/unstable.list

    Delete apt Default-Release configuration.

    sudo rm /etc/apt/apt.conf.d/70defaultrelease

  3. We avoid wget because it does not enforce https.
  4. We avoid scurl, since there is no redirecting stable link. TODO: this can probably be resolved by telling curl to follow redirects.
  5. Monero has a command line interface (CLI) as well as a graphical interface (GUI). Prefer the CLI if you feel at home with the terminal, otherwise choose the GUI.
    • Non-Qubes-Whonix: version 13 users who upgraded to Whonix 14 and above download: Linux 32-bit.
    • Non-Qubes-Whonix: native version 14 and above users download: Linux 64-bit.
    • [[Qubes-Whonix|Qubes-Whonix]]: Linux 64-bit.
Cite error: <ref> tag defined in <references> has no name attribute.

We believe security software like Whonix needs to remain open source and independent. Would you help sustain and grow the project? Learn more about our 12 year success story and maybe DONATE!