Permalink
Switch branches/tags
Nothing to show
Find file Copy path
637 lines (515 sloc) 26.5 KB

Preface

This guide is open source and maintained by ErCiccione, of the Monero community. If you have suggestions or wish to contribute to the development of this guide, feel free to open Pull Requests or Issues on the GitHub repository where this document is maintained: github.com/monero-ecosystem/monero-GUI-guide.  

For the online version of this guide, click here

Translations

This document will be localized into several languages. You can find all available translations in the dedicated section on GitHub.

Windows Preparation

If you are on Windows:

  • Make sure that your antivirus does not block the program.
  • The first time you start the wallet you must give permission to connect to the network via a pop-up. Check the appropriate boxes and click Allow access.

win firewall check

Shortcuts

Some shortcuts are available to make the user experience with the GUI easier:  

On all operating systems:
Press Ctrl to view each page shortcut. Press ctrl+"shortcut" to go to that page  

On Linux/Windows:
ctrl + tab -> go to the next page
ctrl + shift + tab -> go to the previous page  

On macOS:
cmd + tab -> go to the next page
cmd + shift + tab -> go to the previous page

Choose a Language

Language

Extract the package and click on monero-wallet-gui. You'll see a list of available languages, click on the one of your choice and go to the next step.

Create a Wallet

welcome

On this page you can choose how to connect to the wallet and to the network:

  1. Create a new wallet: Start the procedure to make a new wallet. Choose this option if this is your first time using Monero.\
  2. Restore wallet from keys or mnemonic seed: Click here if you want to recover a pre-existing wallet using the mnemonic seed or the keys.\
  3. Open a wallet from file: Choose this option to select a pre-existing wallet from your files with the extension .keys.\
  4. Create new wallet from hardware: Create a new wallet from an hardware device (like Ledger)\
  5. Mainnet: Advanced: use the main Monero network\
  6. Testnet: Advanced: Check this box if you would like to use a development network instead of the main network. Testnet is designed to let developers test new features that are not available on Mainnet or Stagenet.\
  7. Stagenet: Advanced: Check this box if you would like to use a network for staging instead of the main network. Stagenet mimics the features of Mainnet and is designed to let end users test Monero without the risk of losing funds.

Create new wallet

new

Here you can create a new wallet:

  1. Wallet name: Give a name for your wallet (in this example testname is used).\
  2. Mnemonic seed: Write down your mnemonic seed and keep it safe. Your seed is the master key of your wallet, you can use it to recover your funds.\
  3. Wallet location: Select the destination folder of the wallet.

Add a password

add password

Add a strong password to protect your wallet. If you lose your password, then only your mnemonic seed can recover your wallet.

Daemon settings

daemon settings

Here you can choose if you are going to run a full node or use a remote one:

  1. Start node in background: Check this box to run a full node and begin blockchain sync.\
  2. Blockchain location (optional): To store the blockchain somewhere other than default, enter that location here.\
  3. Bootstrap node: To use a bootstrap node enter the host and port. A bootstrap node allows you to use your wallet while you are downloading the blockchain by connecting to a remote node. For a list of available remote nodes and info about them, check the About remote nodes section of this guide.\
  4. Connect to a remote node: Check this box if you want to use only a remote node without downloading the blockchain. You will need to put the host and port of the remote node after checking the box.

Run a full node

Upon completion of the setup you will be prompted to the settings menu, but first you will see a window like this pop up:

sync

If you want to create a normal wallet using your personal full node, you don't need to do anything, let the countdown finish, then wait until your node is fully synced.
If you need some special settings, like setting up a view-only wallet or adding the blockchain manually, go to section 3.

Restore wallet from keys or mnemonic seed

Restoring from seed

restore from seed

Restoring from your mnemonic seed is the easiest way to recover your wallet. You need to put the following information:

  1. Wallet name: Give a name for your wallet (in this example testname is used).\
  2. Mnemonic seed: Paste your seed made of 25 (or 24) words.\
  3. Restore height (optional): If you know the block height that your wallet was created at, you can specify it here so the wallet doesn't have to scan the entire blockchain looking for your funds. For example, if your first transaction was included in block 1350000, you should put a slightly lower height (e.g. 1330000) so the wallet will start scanning from there, saving you some time.\
  4. Wallet location: Select the destination folder of the wallet.

A detailed guide is available on getmonero.org: 'How to restore your account'

Restoring from keys

restore from key

Restoring from keys is quite easy and can be extremely useful, especially if you are moving your wallet from an online service like MyMonero. You need to put the following information:

  1. Wallet name: Give a name for your wallet (in this example testname is used).\
  2. Account address: The address of the wallet you are recovering.\
  3. View key: Your private view key (needed to be able to check your funds).\
  4. Spend key: Your private spend key (needed to spend your funds).\
  5. Restore height (optional): If you know the block height that your wallet was created at, you can specify it here so the wallet doesn't have to scan the entire blockchain looking for your funds. For example, if your first transaction was included in block 1350000, you should put a slightly lower height (e.g. 1330000) so the wallet will start scanning from there, saving you some time.\
  6. Wallet location: Select the destination folder of the wallet.

When everything is ready click the right arrow and then the Use Monero button.
A detailed guide is available on getmonero.org: 'Restoring wallet from keys'

Open a wallet from file

After clicking this option a window will pop up. Navigate to your file with the extension .keys, select it and click the right arrow.

Create new wallet from hardware

Create the wallet

2.4.1

  1. Wallet name: Give a name for your wallet (in this example ledger-test is used).\
  2. Restore Height (optional): If you know the block height that your wallet was created at, you can specify it here so the wallet doesn't have to scan the entire blockchain looking for your funds. For example, if your first transaction was included in block 1350000, you should put a slightly lower height (e.g. 1330000) so the wallet will start scanning from there, saving you some time.\
  3. Subaddress lookahead (optional): pregenerate a number of accounts with a number of subaddresses each\
  4. Device name: Select the hardware wallet you want to use (at the moment, only 'Ledger' is available)\
  5. Wallet location: Select the destination folder of the wallet.  

All next steps are the same as explained from 2.1.1 to 2.1.3  

Step by step guide to generate a Ledger wallet with the Monero GUI for all operating systems (StackExchange):
How do I generate a Ledger Monero wallet with the GUI (monero-wallet-gui)?

Send Monero

send

The Send tab provides tools for creating outgoing transactions.

  1. Amount: This is how much Monero you want to send.\
  2. Transaction priority: This is the priority level your transaction will receive in the pool of transactions waiting to be confirmed. The more you pay, the higher your transactions priority for inclusion in a block.
    Currently staying with the default or the slow option is likely to get you into the next block.\
  3. Address: This is where you put the Monero address that you are sending to. Best practice is to copy and paste the address to prevent errors, accompanied with visually checking that the pasted address is correct.\
  4. Payment ID (optional): The payment ID is an identifier attached to the transaction you are about to send. Often when sending to an exchange they will give you a payment ID that you must include here. This is so they know which incoming transaction is from you.
    If you forget to add your payment ID you should still be able to recover your funds by contacting the party you sent Monero to.\
  5. Description (optional): This is for your record keeping. You can add some information regarding your transaction for future reference.\
  6. Sweep unmixable: This allows you to get rid of outputs in your wallet which have strange amounts like 0.000006839355. These are unmovable without combining them with another output.
    Most users will never need to use this feature.\
  7. Sign tx file: This button allows you to sign a transaction file that was created on a view-only wallet.\
  8. Export key images: This option will allow you to export your key images. They are needed to get the true balance of a view-only wallet.

Address Book

The Address Book tab lets you save addresses that you frequently transact with. This is a convenient place to copy addresses from when creating transactions.

Receive Monero

receive

The Receive tab provides tools for generating subaddresses, crafting payment requests, and monitoring incoming transactions.

  1. Addresses: This is a list of your primary address and subaddresses.\
  2. Create new address: This button allows you to create new subaddresses. You can create as many as you would like. Learn more about subaddresses.\
  3. Advanced options: Clicking here you will be prompted to the advanced section.\
  4. Amount: This is for creating a payment request, enter the amount of Monero you would like to receive.\
  5. Tracking: If you tick this box, you'll see a list of incoming transactions.\
  6. QR code: This is a QR code that has your selected address, and optionally the amount, embedded into it. It can be used as a way to give others your Monero address by scanning the code.

Advanced Features

Solo mining

mining

The Mining tab provides a one click CPU miner that is embedded into the GUI.

  1. CPU threads: Number of CPU threads to use for mining.\
  2. Background mining: Check this box to enable experimental background mining. This should allow you to use your computer normally while mining.\
  3. Start mining: Start the miner.\
  4. Stop mining: Stop the miner.

Prove - Check

Check payment

The Prove/check tab provides tools for proving a payment or validating proof of a payment. This is necessary with Monero because these details are not available on the blockchain.

Prove Transaction

This will generate a proof that you made a payment to a certain address. You need to put the following information:

  1. Transaction ID: This is the ID of the payment you are creating proof for. You can find the transaction details by selecting the History tab from the left menu.\
  2. Address: This is the address you are proving payment to.\
  3. Message (optional): This an optional message that will be signed with the transaction details. If you choose to include a message then the other party must also include the exact same message in order to verify your proof.\
  4. Generate: Click here once you've entered all the details to generate your proof.  

A detailed guide is available on getmonero.org: 'How to prove payment'

Check Transaction

This will verify that a payment was made. You need to put the following information:

  1. Transaction ID: This is the ID of the payment you are attempting to verify.\
  2. Address: This is the receiving address of the payment you are attempting to verify.\
  3. Message (optional): This is the optional message that may have been included with the proof.\
  4. Signature: This is the signature generated to prove payment.\
  5. Check: Click here once you've entered all the details to check that the transaction proof is valid.

Shared RingDB

shared ringdb

This is an advanced tool that can be used to improve the privacy of ring signatures. The outputs used in ring signatures can be adapted to mitigate the privacy loss when using a key-reusing fork or to avoid outputs that could not be spent in this transaction.

  1. Blackball filename: This tool will blackball outputs that are known to be spent. After running monero-blockchain-blackball, import the resulting file to avoid using these outputs as decoys in constructed ring signatures. This file is stored in the .shared-ringdb folder by default.\
  2. Blackball output: This will blackball or unblackball a chosen single output. Outputs are represented by 64-character strings. The outputs added in this field will not be used as decoys in constructed ring signatures. Unblackballed outputs may (but will not necessarily) by used as decoys.\
  3. Key image input: Add the key image that was used on the key-reusing fork.\
  4. Get ring: Press the "Get Ring" button to get the ring members for the given key image in 3.\
  5. Set ring: Press the "Set Ring" button to set the ring members for a transaction. Copy the ring members from 4 to get those for the key image, or manually type in your own.\
  6. Intent to spend: Select this if you are certain that you will spend Monero on a key-reusing fork. This will aggressively modify the input selection algorithm to give you the greatest plausible deniability.\
  7. Possibility to spend: Select this if you may spend Monero on a key-reusing fork. This will modify the input selection algorithm. Uncheck this only if you are certain you will not use a key-reusing fork.\
  8. Relative: When selected, the offsets are encoded relative to the previous, as opposed to absolute (transactions use relative offsets).\
  9. Segregation height: The block height at which the key-reusing fork splits.

Sign - verify

sign/verify

The Sign/verify tab provides tools for signing a message or file with your private key or verifying the authenticity of a singed message or file.

Sign

  1. Message: This is where you can enter a message to be signed.\
  2. Message from file: This is where you can choose a file to be signed. Click Browse to navigate the file system.\
  3. Signature: This is where your unique signature will appear once you click the Sign button. This is linked to your private key and the message or file you entered. It will be given as proof along with the message or file which was signed.

Verify

  1. Verify message: This is where you will put a message that has been signed.\
  2. Verify file: This is where you enter the path to a file that has been signed. Click Browse to navigate the file system.\
  3. Address: This is where you will enter the public Monero address of the signer.\
  4. Signature: This is where you will enter the signature you are verifying. Once all the required information has been entered click the Verify button. A pop-up will tell you if the signature is valid.

Settings

The Settings tab provides tools for customizing configuration options.

Wallet

settings-wallet

Local Node

settings_local-node

  1. Start/Stop Local Node: Depending on its current state, either start or stop the local node.\
  2. Blockchain location: Manually enter a non-default path to the blockchain.\
  3. Startup flags: When using a local node, this will be where you enter additional command line options.\
  4. Bootstrap Address: Enter the hostname or IP address of the bootstrap remote node. See section 8.1 Bootstrap nodes for a brief explanation of what is a bootstrap node.\
  5. Bootstrap Port: Enter the port of the bootstrap remote node.

Remote Node

Use a remote node, do not download the blockchain. Check the 'About remote nodes' section of this guide.

settings_remote-node

  1. Address: Enter the hostname or IP address of the remote node.\
  2. Port: Enter the port of the remote node.\
  3. Daemon Username: enter a username in case authentication to the remote node is required.\
  4. Daemon Password: enter a password in case authentication to the remote node is required.

Log

settings-log

  1. Log level: Change the verbosity of the debug logs.\
  2. Log categories: Add specific categories to the debug logs.\
  3. Daemon log: Real time output of the log.\
  4. Command line: Interact with the daemon.

Info

settings-info

  1. GUI Version: Version of the GUI wallet installed.\
  2. Embedded Monero Version: Version of the embedded daemon in use.\
  3. Wallet path: Where the wallet is located on your computer.\
  4. Wallet creation height: Change the block height that a wallet rescan will go back to.\
  5. Wallet log path: Where the logs for this wallet will be saved.\
  6. Copy to clipboard: Copy all this information to the clipboard.

Seed and keys

seed-keys

The Seeds & Keys tab displays your wallets mnemonic seed as well as your secret view key, public view key, secret spend key, and public spend key.

  1. Mnemonic seed: DO NOT share your mnemonic seed with anyone. Store a copy securely. The mnemonic seed is a 25 word phrase that contains all the information needed to view and spend funds. Learn more about mnemonic seeds.\
  2. Secret view key: Secret view keys allows the holder to view your wallets incoming transactions, but not outgoing. It is sometimes useful for auditing purposes to give your secret view key to a third party.\
  3. Public view key: The public view key is used for stealth address creation. Learn more about view keys.\
  4. Secret spend key: DO NOT share your secret spend key with anyone. The secret spend key is used to sign transactions and should be regarded with the same security as your mnemonic seed.\
  5. Public spend key: The public spend key is used by the network to verify the signature of the key image you generate when you make a transaction. This is what prevents double-spends as the network enforces the rule that a key image can be spent only once. Learn more about spend keys.\
  6. Export Spendable Wallet: DO NOT share your spendable wallet QR code with anyone. This can be used like a mnemonic seed for recovering your wallet. This creates a qrcode that contains all of your keys.\
  7. Export View Only Wallet: This creates a QR code that contains only the keys for viewing the transactions that this wallet sends or receives, but cannot create transactions.

Binaries Verification

Verify that the files you downloaded match the official ones. You can use this step-by-step guide with pictures (easy, for Windows user).

About remote nodes

Remote nodes can be very useful if you are not able/don't want to download the whole blockchain, but be advised that malicious remote nodes could compromise the level of privacy of your transaction, tracking your IP or, in extreme cases, even showing the amount transacted. That said, a list of remote nodes can be found at moneroworld.com. Keep in mind anybody is able to add a node to that list, you shouldn't consider those nodes as trusted or safe, always run your own node for the best privacy.

Bootstrap nodes

A bootstrap node is a remote node to use whilst also syncing the blockchain. This is different to a straight up remote node in that using a remote node will not also sync the blockchain to local.
If the bootstrap node feature is utilized it will always automatically switch to the local node when the blockchain is fully synced, regardless of whether the user put in the remote node themselves or the remote node was specified by default.
More info at https://getmonero.org/resources/moneropedia/bootstrap-node.html

Common issues and solutions