Troubleshooting Tips for Armory

Troubleshooting Tips for Armory

Armory is an advanced contraption for accessing the elaborate Bitcoin network. The developers have gone to good length to improve the user practice and are always working to fix known issues. If you encounter fights using Armory, the tips below may provide you with solutions to your problems. Due to the sheer magnitude of Armory downloads, wij are incapable to personally reaction every support toegangsbewijs or email. To stay updated on the latest versions, you can subscribe to our mailing list or go after us on Twitter (@armory). Wij encourage you to browse our webstek FAQ and Troubleshooting sections if you have questions or difficulty using Armory. Additionally, you can visit the public forums at and find helpful solutions spil well spil postbode your kwestie there.

If you think you are encountering a truly unique problem not listed on our webpagina or ter the forums, please go to our Support Pagina and submit your loom verkeersopstopping and a schrijven description. You can retrieve your loom opstopping by opening Armory and going to “File >, Uitvoer Loom Opstopping.”

Update to latest version of Armory and Bitcoin Core

Before you begin troubleshooting, make sure you’re using the latest version of Armory and Bitcoin Core.

Resetting Armory

Attempt going into the computer’s begin spijskaart and finding the entry for “Armory Bitcoin Client”. Click on the option that says “Armory (Offline)”. This will fountain Armory without most of the operations that cause loading problems. Once that is open, you can go to “Help”–>,”Revert All Settings”. This is effectively a “factory reset” of Armory to the state it wasgoed ter before the very first time you used it. Alternatively, you can also navigate to “Help” ->, “Factory Reset” and revert the settings spil well spil force a finish rebuild of the blockchain.

Why does Armory take so long to download?

The time to download is a function of the download size, your pc spectacle, spil well spil your connection speed. The download size commencing te 2014, is overheen 40GB. During the download, do not interrupt the download and synchronization process spil gegevens corruption can occur. If this does toebijten, you may be coerced to re-download the entire blockchain. Before assuming you are experiencing an excessive or unusually long download time, be sure you are minimizing resource usage on your laptop, and verify the quality of your internet connection. You can obtain the spectacle of your internet connection at www.speedtest.netwerken and www.pingtest.netwerk. For reference, at the commence of 2014, a Windows 7, 64-bit system, with a 2GHz Quad-core CPU, and 6.0 GB of RAM on a 47 Mbps connection took Five hours to download the blockchain and install Armory, embark to finish. You may practice longer or shorter download times depending on your equipment and connection speed.

Why does Armory use so much hard drive space?

The Bitcoin Core engine (bitcoind) generates a database, spil well spil the Armory engine (armoryd). Spil a result, there is a large hard drive space requirement to store the entire blockchain. Additionally, spil the blockchain grows, the space required grows spil well.

How can I switch the blockchain database storage location for Armory and Bitcoin Core?

Armory Huis Directory – The location for the armory database. Default location is C:\Users<,user>,\AppData\Wandering\Armory folder

Installation Directory – The location where the Armory program files are installed. Default location is C:\Program Files (x86)\Armory

The instructions below relocate the entire Bitcoin Core and/or Armory directories (dirs). By moving the entire dirs, the wallet files will stay te the same location spil the databases (db’s).

Alternatively, the db’s may be independently moved from the dirs (using directive “–dbdir”) but should only be done to specifically separate the db’s from the dirs

A) Wagen run Bitcoin Core (system default) MAC users** ** Voorwaarde USE ** **Option (B)

Navigate to alternate Bitcoin Core storage location and create the fresh target dir, for example F:\Bitcoin\fresh\huis\dir

Te Armory, go to “File >, Settings” and set the “Bitcoin Huis Dir” folder to the fresh target dir F:\Bitcoin\fresh\huis\dir

Budge everything from your Bitcoin Core huis dir ( C:\Users<,username>,\AppData\Wandering\Bitcoin ) to the fresh target dir F:\Bitcoin\fresh\huis\dir

Close Bitcoin Core and Armory

Navigate to alternate Bitcoin Core storage location and create the fresh target dir, for example F:\Bitcoin\fresh\huis\dir

Budge everything from your Bitcoin Core huis dir ( C:\Users<,username>,\AppData\Wandering\Bitcoin ) to the fresh target dir_ _ F:\Bitcoin\fresh\huis\dir

Navigate to the original Bitcoin installation folder:

Right-click on the verkeersopstopping “bitcoin-qt” select “Send to” and select “Desktop (create shortcut)”

Navigate to the original Armory installation folder:

Right-click on the verkeersopstopping “ArmoryQt” select “Send to” and select “Desktop (create shortcut)”

Go to the desktop, right click each of the fresh shortcuts just created, and select “Properties.” Select the “Shortcut” tabulator. Next, go to the “Target” field and add the following directive line arguments to the end (Paths for both shortcuts Voorwaarde be the same** _ unless _ **moving BOTH directories – see below)

Bitcoin Core shortcut: -datadir= F:\Bitcoin\fresh\huis\dir __ ”

  • For example _ ” _C:\Program Files (x86)\Bitcoin\bitcoin-qt.exe_ ” _ -datadir=_ ” _F:\Bitcoin\fresh\huis\dir_ ” _

Armory shortcut: –satoshi-datadir=_ ” _F:\Bitcoin\fresh\huis\dir_ ” _

Commence Bitcoin and Armory using the freshly created shortcuts. Te the Armory, de-select the check opbergruimte that says “Let Armory run BitcoinQt…”

When Bitcoin Core is fully synchronized, embark Armory using the modified Armory shortcut

Navigate to preferred Armory storage location and create the fresh target dir, for example F:\Armory\fresh\huis\dir

Navigate to the original Armory installation folder:

Right-click on the verkeersopstopping “ArmoryQt.exe.” Select “Send to” and select “Desktop (create shortcut)”

Go to your desktop, right click the fresh shortcut just created, and select “Properties.” Select the “Shortcut” tabulator. Next, go to the “Target” field and add the following instruction line arguments to the end: –datadir= ” F:\Armory\fresh\huis\dir ”

Embark Armory using the freshly created shortcut

  • For example _ ” _C:\Program Files (x86)\Armory\ArmoryQt.exe” –datadir=_ ” _F:\Armory\fresh\huis\dir_ ” _
  1. Finish both steps above but instead, modify Armory Shortcut by adding: –satoshi-datadir=_“_F:\Bitcoin\fresh\huis\dir_ ” _ –datadir=_ ” _F:\Armory\fresh\huis\dir_ ” _

To stir ONLY the databases

  1. Use the similar steps above but substitute the database instruction: _ –dbdir= ” ” <,/span>,_

Make sure your system clock is keurig to avoid “frozen” state

Sometimes, when installing Armory for the very first time and synchronizing with the network, Armory will freeze at a given percentage. This is a common problem associated with an erroneous system clock on the pc not matching the time stamp of the Bitcoin network.

To fix this problem:

Te windows, right-click on the time and select “Adjust Date and Time.” Then, set the juist Date and Time. It’s also critical that you select your decent timezone. Optionally, you may also choose to go to the Internet time tabulator and permit windows to automatically synchronize with the Internet time. For more informatie, refer to:

Ter Ubuntu, right-click on the time, then select “Time &, Date Settings…”. Click your location on the ordner to select the keurig timezone and then by hand adjust the time at the bottom if necessary. For more information, refer to:

Armory crashes after completing blockchain download, but before it starts rebuilding the database

When saving the Armory database to a network share, you should use both the –settings=”local path on C:” and the –datadir=”\server\share\dir” together spil the settings directory needs to be a local directory. Otherwise, it may crash if it’s on a network share.

Bitcoin Core/bitcoind rejects connection from Armory

Some advanced users have a custom-built bitcoin.conf opstopping which causes Bitcoin Core/bitcoind to turn down the connection from Armory. This advice only applies to users which have a custom-built “bitcoin.conf”, perhaps for running Bitcoin miners, or tweaking network usage and security.

Be aware that Armory connects to Bitcoin Core or bitcoind spil a regular peer, not through RPC. Spil such, the bitcoin.conf requires permitting incoming connections from The following lines are example options te bitcoin.conf:

You should consider adding the very first two lines if you are convenient with the security implications, and possibly removing the maxconnections line if you proceed to have problems (Bitcoin Core/bitcoind may pack up all its connections with outward peers, not permitting it to allocate any to Armory).

“Armory won’t begin anymore. Help!”

While Armory is still te Beta, there are still some subtle bugs that cause Armory to misbehave on systems. Armory developers are always working to fix thesis problems, but it usually requires a bug report submitted from Armory, or you can open a support toegangsbewijs so we’re aware of the problem and can attempt to fix it. One thing you can attempt, is to go into the embark menukaart and find the entry for “Armory Bitcoin Client”. Click on the option that says “Armory (offline)”. This will geyser Armory without most of the operations that cause loading problems. Once that is open, you can go to “Help”–>,”Revert All Settings”. This is effectively a “factory reset” of Armory to the state it wasgoed ter before the very first time you used it.

Armory crashes every time I type ter my password

The crash is most likely the result of a omkoopbaar wallet opstopping. If you do not have a wallet backup, you will need to open a support toegangsbewijs via the Armory support pagina. If you have a backup, go after the directions below:

(1) Make a copy of the original, corrupted wallet, te case the backup you are about to use does not work for some reason. Double-click on the corrupted wallet, and make a “digital backup”. Save the verkeersopstopping somewhere safe.

(Two) Te the same wallet properties, click “Delete/Eliminate Wallet”. Entirely eliminate the wallet. It should vanish from the Armory interface.

(Trio) From the main Armory window, click on the “Wallets” spijskaart and select “Import or Restore Wallet”.

(Four) Select the type of backup you have to restore your wallet. Go after the directions.

(Five) Go into the restored wallet properties and click “Change Wallet Labels” and type te the original name of the wallet.

You should be able to see your balances at this point. If something did not go right, just restart Armory. If you still don’t see the balances you expect, go to “Help”–“Rescan Databases” and then restart Armory.

I just setup my offline wallet but where is my balance?

The offline rekentuig is basically a signing authority. It is not connected to the internet or Blockchain, so there should not be any balance information available.

Can I Use My Bitcoin Core Wallet Ter Armory?

Unluckily, Armory does not support the same address format used by Bitcoin Core. The feature wasgoed available te Armory until the fresh format wasgoed adopted by Bitcoin Core te April 2012. However, Armory will be upgrading its own wallet format very soon, to support wallet types of lots of different programs, te addition to supporting multi-signature transactions (see below). However, even if Armory could use Bitcoin Core wallets, they would need to be backed up every duo of months because they are “non-deterministic.” For this reason, it is recommended that you create a native Armory wallet, and transfer your funds to it instead of waiting for the migration feature (and then make a paper backup of it!). Anything that could be done with a Bitcoin Core wallet can be done with an Armory wallet. Also, Armory has a feature that makes it effortless to uitvoer your private keys, so that they can be imported into another program (such spil Bitcoin Core). If you attempt Armory and determine you don’t like it, you can use this feature to “migrate” your Armory wallet to another application. However, for a diversity of reasons, it is still recommended to just send the funds to the other wallet instead of migrating.

Help! I’ve forgotten my wallet encryption password!

Do you have a paper backup? If so, it is recommended you make a digital backup of your encrypted wallet (just ter case something goes wrong and then you recall your password straks), then stir the wallet from Armory folder to a save location. Then use the “Import Wallet” dialog to restore your paper backup. If you do not have a paper backup or an unencrypted digital backup, you will need to open a support toegangsbewijs via the Armory support pagina.

NOTE: Armory wallet encryption wasgoed specifically designed to be sturdy against state-of-the-art encryption-cracking mechanisms. This is what will protect your funds if an attacker obtains your wallet verkeersopstopping, but it is also what makes it difficult for you to recover your wallet if you leave behind your passphrase. Your passphrase is the encryption key for your wallet, and thus you are te the same boots spil a potential attacker if you leave behind it — it will be almost unlikely to recover the wallet unless you can reminisce substantial portions of the passphrase. The more you can reminisce, the more likely you will be able to recover it. However, ter almost all cases, you will need to hire someone with skill of encryption and who has access to a lotsbestemming of computing power. For reference, if you use a fully random 6-character passphrase for your wallet, and you cannot reminisce anything about it, it will take your rekentuig up to 900 years to recover your wallet. However, if you recall most chunks of your password, an pro may be able to help you recover your wallet te a few days. To prevent this from happening to you:

– Don’t leave behind your passphrase!

– Make a paper backup of your wallets and keep it safe!

If you find yourself te this situation anyway, open a support toegangsbewijs via our support pagina.

I sent a transaction, but it is “stuck” with 0 confirmations

This problem can toebijten when there is a improvised disconnection from the network right spil you attempt to broadcast your transaction. It can also occur with low-value transactions. Unluckily, the way Armory and Bitcoin Core work make it difficult for Armory to onberispelijk this situation on its own. However, this error is lightly resolved by hand.

If you let Armory manage Bitcoin Core for you (or you do not know what this means) : Go to “Help”->,”Clear All Unconfirmed”. Then restart Armory. Send/broadcast your transaction again.

If you manage Bitcoin Core/bitcoind by hand : Go to “Help”->,”Clear All Unconfirmed”. Then restart both Armory and Bitcoin Core/bitcoind. Send/broadcast your transaction again.

If this does not help, it’s possible that the network is simply processing your transaction with very low priority. This can toebijten to transactions that are puny te value (BTC), large te size (kilobytes), and do not have fees affixed. You can avoid this by including a 0.0001 BTC toverfee on all your transactions by default. If this is the problem, you will be able to right-click on the transaction te your history and select “View on”. If the webstek shows you an “Unconfirmed!” transaction, you will just have to wait.

English is not your native language/locale

Unluckily, Armory has trouble with the letters that emerge ter languages that are not part of the English alphabet (like, aoe). This is a known problem with Armory and will be stationary after Armory version 0.90-beta. Until then, you can help Armory by avoiding thesis “unicode” characters ter the following places:

  • Comment fields for addresses and transactions
  • Any of the fields ter the settings window
  • Username and password te bitcoin.conf verkeersopstopping (problematic te Windows, only)

The wallets that Armory uses were not originally created with unicode support. However, a fresh wallet opstopping format is being created that is unicode-friendly, and should be released ter Armory version 0.90-beta.

If you are using a non-US keyboard and were using Armory before version 0.88.1, then you may have bot able to use Armory but then became locked out spil of the latest version. Version 0.87.Two may still work for you. It can be retrieved from the googlecode download pagina.

Armory can’t find my Bitcoin installation, but I know it’s installed!

Very first of all, make sure you understand how Armory and the core Bitcoin software work together.

This problem is especially confusing te Linux, because of the multiplicity of non-standard configurations. Te Windows, it also happens when you don’t install to the default location. Te both cases, you need to go into “File”->,”Settings”, and point to where it is installed. Due to some quirks te the way Armory finds the executables on Windows, you may need to actually point it to the “daemon” directory within the install directory. For example: “C:\Program Files (x86)\Bitcoin\daemon”.

The most common point of confusion is that Armory is not looking for “bitcoin-qt”, it is looking for “bitcoind” — it’s a different executable. This is the version of Bitcoin software that runs ter the background with no user interface. If you are ter Ubuntu using the Bitcoin PPA you have to install it separately: ”sudo apt-get install bitcoind“. Or use the “Auto-Install” button which will actually setup the Ubuntu PPA for you, if it’s not already. The auto-install button will actually install both Bitcoin Core and bitcoind.

Error opening block database. Do you want to rebuild the block database now?”

When you receive this error, it is actually a problem with the underlying Bitcoin Core/bitcoind (from, not related to Armory itself. Armory simply relies on their software to communicate securely with the Bitcoin network. If you see this error, the only way to resolve it is to redownload the entire 20+ GB of blockchain gegevens. Obviously, this can take a long time: Four to 48 hours depending on your connection. Unluckily, we’re not aware of any other options. Please go after the directions below labeled “Deleting and Redownloading the Blockchain.”

If you have further problems with StdOut/StdErr messages like this, you will have to voeling the core developers either through the forums or IRC channel. Wij don’t produce that software, wij are only familiar with troubleshooting this particular error.

Deleting and Redownloading the Blockchain

(1) Make sure Armory is closed. If you run Bitcoin Core/bitcoind yourself, close that spil well.

(Two) You need to find the Bitcoin Core/bitcoind huis directory ter your opstopping browser. It can be found:

  • Windows : C:\Users<,username>,\AppData\Wandering\Bitcoin
  • _ Linux : /huis/ /.bitcoin_
  • _ MacOSX : /Users/ /Library/Application Support/Bitcoin_

(Three) Within that directory, liquidate all files and folders EXCEPT wallet.dat. The only opstopping remaining should be wallet.dat!

(4a) If you don’t run Bitcoin Core/bitcoin by hand (or don’t know what I’m talking about), just embark Armory. It will run bitcoind ter the background, which will resynchronize with the network (Four to 48 hours depending on your connection).

(4b) If you run Bitcoin Core/bitcoind by hand, restart it. Wait for it to finish synchronizing with the network (4-48 hours depending on your connection). A green checkmark will emerge ter the bottom-right corner when it’s done. Then begin Armory.

How do I setup Armory on the Test Network (Testnet)

If you want to attempt out Armory’s features without committing real funds, Testnet is a good resource. Testnet is used to describe the Test Network. It is essentially the same thing spil the Bitcoin network, but it uses “Testnet coins” to help developers test features and functionality. All testnet addresses embark with “m” while all Bitcoin addresses embark with “1”. You can get testnet coins for free because they have no value. Do not accept testnet coins for any commercial transaction – they are worthless. You can mine them yourself or search for a generous Testnet Faucet provider like

To run Armory on testnet, you’ll have to disable auto-bitcoind and run Bitcoin-Qt or bitcoind ter testnet mode by hand. The process can be misleading because Armory and Bitcoin-Qt/bitcoind use veranderlijk directive line arguments. For example, you use “-testnet” flag with Bitcoin-Qt/bitcoind and “–testnet” flag for Armory (yes, one slash for bitcoin, two slashes for Armory). Here’s the detailed breakdown to use Armory te the “Test Network” mode:

Open Bitcoin Armory (testnet), navigate to the settings panel, and deselect “Let Armory run Bitcoin-Qt/bitcoind ter the background.”

Next, navigate to the location of your Bitcoin Core installation, for example C:\Program Files\Bitcoin. Once there, it is easiest to click on the “bitcoin-qt” application and create a shortcut. Next, you need to switch the target or guideline to the following:

Windows: “C:\Program Files (x86)\Bitcoin\bitcoin-qt.exe” -testnet

Linux/Ubuntu: /usr/bin/bitcoin-qt -testnet

Ultimately, click on the freshly created shortcut to activate the Bitcoin Core test network. Once Bitcoin Core is finished syncing, you can embark Bitcoin Armory (testnet) and you will have access to the Test Network.

*NOTE: Due to some quirks te the path resolution, if you want to use a custom-built directory for Armory and Bitcoin, the –datadir and –satoshi-datadir arguments are onbestendig. For example, if you moved both your bitcoin huis dir and your armory huis dir to F:\Bitcoin and F:\Armory, respectively, do the following:

bitcoind.exe -testnet -datadir=F:\Bitcoin

Armory.exe –testnet –datadir=F:\Armory\testnet3 –satoshi-datadir=F:\Bitcoin

The problem is that Bitcoin-Qt expects the base bitcoin huis directory, even for testnet, and will add the “testnet3” for you. If you specify F:\Bitcoin\testnet3, it will run ter F:\Bitcoin\testnet3\testnet3. However, this wasn’t realized when primarily setting up the code for processing arguments, and therefore, Armory requires explicitly specifying the total path.

Connection Issues (advanced)

Sometimes Armory practices problems connecting to Bitcoin Core. The most significant thing to know is that Armory connects to Bitcoin Core spil a peer (overheen localhost sockets), instead of through RPC. This means that Bitcoin Core needs to permit incoming connections. This trips up many users that have custom-built bitcoin.conf files that limit connections and connection types. Sometimes you may not actually know there is an punt until you attempt to send coins. If you run into such an kwestie, it is recommended you delete your bitcoin.conf verkeersopstopping and restart everything, and see if the problem is resolved.

Rebuilding and Rescanning Armory’s Databases

The databases that Armory builds and uses are very large (20+ GB), and it is possible for them to become corrupted, especially if Armory did not shut down cleanly. This requires a total rebuild+rescan. Sometimes, the databases are fine and simply have bot processed incorrectly by Armory. Te this case they only need to be rescanned.

  • If Armory crashes while commencing up, especially while scanning, you may need to “Rebuild and Rescan Databases” from the “Help” menukaart.
  • If you practice missing transactions and/or incorrect balances, you may simply need to “Rescan Databases” from the “Help” menukaart.
  • If you have zero-confirmation transactions that are ter your transaction history but are not found when you right-click and “View on”, then “Clear all Unconfirmed” from the “Help” menukaart.

Te all three cases, you will need to restart Armory for the corrective activity to be applied decently. If you had stuck zero-confirmation transactions and used “Clear all Unconfirmed”, you will need to rebroadcast your transaction after you restart.

Take note, there is a bug ter the “Rebuild and Rescan” operation, which will fail if the database is badly corrupted. If you use the “Rebuild and Rescan Databases” operation, but Armory still crashes shortly after beginning up, you will need to by hand liquidate the databases. Close Armory, then navigate to the Armory huis direcotry te a verkeersopstopping browser:

  • Windows : C:\Users<,username>,\AppData\Wandering\Armory
  • _ Linux : /huis/ /.armory_
  • _ MacOSX : /Users/ /Library/Application Support/Armory_

Once there, delete the “databases” directory. When Armory is restarted, it will rebuild the databases from scrape. Spil mentioned before, do not attempt this step unless the “Help”->,”Rebuild and Rescan Databases” option does not work.

Command-Line Options

The following options can be appended to the call to blast Armory. If you are te Windows, this can be done by making a shortcut to Armory on your desktop, and then right-click on the shortcut and select “Properties”. You can add the options to the end of the “Target:” line, with a space before each one. For example, the default “Target:” is:

If you would like to skip the online check because you are behind a proxy, you would switch “Target:” to:

Note that Bitcoin Core (and bitcoind), does not use standard convention: it uses a single-dash to specify long arguments. Armory uses the standard linux convention of using two dashes for thesis options. Therefore, if you normally run Bitcoin Core with an alternate gegevens directory, such spil:

You would run Armory using:

You can get a total list of terminal options by running Armory from the instruction line with “–help”. Here is the output with abridged comments

Does Armory support BIP38 (private encrypted key)?

Armory Technologies does not support any backup mechanisms that require the user’s memory for recovery of their wallet and funds. Humans leave behind passwords all the time, which is especially relevant when that password may not be used for years until the backup is eventually needed. Furthermore, it is very significant to us to encourage users to create backups te a way that their heirs will be able to recover their wallets ter the event of disappearance or death. Any backups that require the original user’s memory will result te permanently lost coins.

Many users want BIP38 encrypted backups because they want to limit single-points of failure – i.e the backup being found by an unauthorized person. BIP38 enable a kleintje of 2-of-2 backup: te order to restore your wallet, you need a chunk of paper and a chunk of information ter your brain. Armory achieves the same purpose but without user’s memory, by providing fragmented backups. You can make a 2-of-2 backup which is a safer version of BIP38 encrypted backups. Te fact, a 2-of-3 or 3-of-5 is even better, spil it adds redundancy ter addition to security.

Wij understand this doesn’t necessarily meet 100% of use cases, but wij also find it our duty to help guide users to best practices that ensure both security and “continuity,” especially since many of thesis aspects of using and securing bitcoins are non-intuitive.

Related movie: How to Leap A Motherboard Without Power Button

Leave a Reply

Your email address will not be published. Required fields are marked *