1.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
2.TH BITCOIN-QT "1" "October 2026" "bitcoin-qt v32.1.0" "User Commands"
3.SH NAME
4bitcoin-qt \- manual page for bitcoin-qt v32.1.0
5.SH SYNOPSIS
6.B bitcoin-qt
7[\fI\,options\/\fR] [\fI\,URI\/\fR]
8.SH DESCRIPTION
9Bitcoin Core version v32.1.0
10.PP
11The bitcoin\-qt application provides a graphical interface for interacting with Bitcoin Core.
12.PP
13It combines the core functionalities of bitcoind with a user\-friendly interface for wallet management, transaction history, and network statistics.
14.PP
15It is suitable for users who prefer a graphical over a command\-line interface.
16.PP
17You can optionally specify a payment [URI], in e.g. the BIP21 URI format.
18.SH OPTIONS
19.HP
20\fB\-alertnotify=\fR<cmd>
21.IP
22Execute command when an alert is raised (%s in cmd is replaced by
23message)
24.HP
25\fB\-allowignoredconf\fR
26.IP
27For backwards compatibility, treat an unused bitcoin.conf file in the
28datadir as a warning, not an error.
29.HP
30\fB\-assumevalid=\fR<hex>
31.IP
32If this block is in the chain assume that it and its ancestors are valid
33and potentially skip their script verification (0 to verify all,
34default:
3500000000000000000000748969ec33043c0e52a763c6dd5193861f559f2c72e3,
36testnet3:
3700000000b318a3703d14a844c55ef507f4c2fc8f8766e24271fd43c180c51637,
38testnet4:
390000000021df65b91665a342e26ceb05e54826ad7d8fcd40316230058fa3b865,
40signet:
4100000002a5e0ba0498f1e9f4591af0b66b63c654665efe65206fd0ae7bbaf923)
42.HP
43\fB\-blockfilterindex=\fR<type>
44.IP
45Maintain an index of compact filters by block (default: 0, values:
46basic). If <type> is not supplied or if <type> = 1, indexes for
47all known types are enabled.
48.HP
49\fB\-blocknotify=\fR<cmd>
50.IP
51Execute command when the best block changes (%s in cmd is replaced by
52block hash). Not run for blocks connected during initial block
53download or reindexing.
54.HP
55\fB\-blockreconstructionextratxn=\fR<n>
56.IP
57Extra transactions to keep in memory for compact block reconstructions
58(default: 100)
59.HP
60\fB\-blocksdir=\fR<dir>
61.IP
62Specify directory to hold blocks subdirectory for *.dat files (default:
63<datadir>)
64.HP
65\fB\-blocksonly\fR
66.IP
67Whether to reject transactions from network peers. Disables automatic
68broadcast and rebroadcast of transactions, unless the source peer
69has the 'forcerelay' permission. RPC transactions are not
70affected. (default: 0)
71.HP
72\fB\-blocksxor\fR
73.IP
74Whether an XOR\-key applies to blocksdir *.dat files. The created XOR\-key
75will be zeros for an existing blocksdir or when `\-blocksxor=0` is
76set, and random for a freshly initialized blocksdir. (default: 1)
77.HP
78\fB\-coinstatsindex\fR
79.IP
80Maintain coinstats index used by the gettxoutsetinfo RPC (default: 0)
81.HP
82\fB\-conf=\fR<file>
83.IP
84Specify path to read\-only configuration file. Relative paths will be
85prefixed by datadir location (only useable from command line, not
86configuration file) (default: bitcoin.conf)
87.HP
88\fB\-daemon\fR
89.IP
90Run in the background as a daemon and accept commands (default: 0)
91.HP
92\fB\-daemonwait\fR
93.IP
94Wait for initialization to be finished before exiting. This implies
95\fB\-daemon\fR (default: 0)
96.HP
97\fB\-datadir=\fR<dir>
98.IP
99Specify data directory
100.HP
101\fB\-dbcache=\fR<n>
102.IP
103Maximum database cache size <n> MiB (minimum 4, default: 1024). Make
104sure you have enough RAM. In addition, unused memory allocated to
105the mempool is shared with this cache (see \fB\-maxmempool\fR).
106.HP
107\fB\-debuglogfile=\fR<file>
108.IP
109Specify location of debug log file (default: debug.log). Relative paths
110will be prefixed by a net\-specific datadir location. Pass
111\fB\-nodebuglogfile\fR to disable writing the log to a file.
112.HP
113\fB\-help\fR
114.IP
115Print this help message and exit (also \fB\-h\fR or \-?)
116.HP
117\fB\-includeconf=\fR<file>
118.IP
119Specify additional configuration file, relative to the \fB\-datadir\fR path
120(only useable from configuration file, not command line)
121.HP
122\fB\-loadblock=\fR<file>
123.IP
124Imports blocks from an external file on startup. Obfuscated blocks are
125not supported.
126.HP
127\fB\-maxmempool=\fR<n>
128.IP
129Keep the transaction memory pool below <n> megabytes (default: 300)
130.HP
131\fB\-mempoolexpiry=\fR<n>
132.IP
133Do not keep transactions in the mempool longer than <n> hours (default:
134336)
135.HP
136\fB\-par=\fR<n>
137.IP
138Set the number of script verification threads (0 = auto, up to 15, <0 =
139leave that many cores free, default: 0)
140.HP
141\fB\-persistmempool\fR
142.IP
143Whether to save the mempool on shutdown and load on restart (default: 1)
144.HP
145\fB\-persistmempoolv1\fR
146.IP
147Whether a mempool.dat file created by \fB\-persistmempool\fR or the savemempool
148RPC will be written in the legacy format (version 1) or the
149current format (version 2). This temporary option will be removed
150in the future. (default: 0)
151.HP
152\fB\-pid=\fR<file>
153.IP
154Specify pid file. Relative paths will be prefixed by a net\-specific
155datadir location. (default: bitcoind.pid)
156.HP
157\fB\-prevoutfetchthreads=\fR<n>
158.IP
159Set the number of threads used to prefetch block input prevouts from the
160chainstate database (0 disables, up to 16, default: 8). Negative
161values are rejected.
162.HP
163\fB\-prune=\fR<n>
164.IP
165Reduce storage requirements by enabling pruning (deleting) of old
166blocks. This allows the pruneblockchain RPC to be called to
167delete specific blocks and enables automatic pruning of old
168blocks if a target size in MiB is provided. This mode is
169incompatible with \fB\-txindex\fR. Warning: Reverting this setting
170requires re\-downloading the entire blockchain. Wallets and
171indexes should be loaded at startup and kept active while pruning
172is enabled so they stay synchronized before old block data is
173deleted; wallets or indexes that fall behind pruned data may
174require a reindex. (default: 0 = disable pruning blocks, 1 =
175allow manual pruning via RPC, >=550 = automatically prune block
176files to stay under the specified target size in MiB)
177.HP
178\fB\-reindex\fR
179.IP
180If enabled, wipe chain state and block index, and rebuild them from
181blk*.dat files on disk. Also wipe and rebuild other optional
182indexes that are active. If an assumeutxo snapshot was loaded,
183its chainstate will be wiped as well. The snapshot can then be
184reloaded via RPC.
185.HP
186\fB\-reindex\-chainstate\fR
187.IP
188If enabled, wipe chain state, and rebuild it from blk*.dat files on
189disk. If an assumeutxo snapshot was loaded, its chainstate will
190be wiped as well. The snapshot can then be reloaded via RPC.
191.HP
192\fB\-settings=\fR<file>
193.IP
194Specify path to dynamic settings data file. Can be disabled with
195\fB\-nosettings\fR. File is written at runtime and not meant to be
196edited by users (use bitcoin.conf instead for custom settings).
197Relative paths will be prefixed by datadir location. (default:
198settings.json)
199.HP
200\fB\-shutdownnotify=\fR<cmd>
201.IP
202Execute command immediately before beginning shutdown. The need for
203shutdown may be urgent, so be careful not to delay it long (if
204the command doesn't require interaction with the server, consider
205having it fork into the background).
206.HP
207\fB\-startupnotify=\fR<cmd>
208.IP
209Execute command on startup.
210.HP
211\fB\-txindex\fR
212.IP
213Maintain a full transaction index, used by the getrawtransaction rpc
214call (default: 0)
215.HP
216\fB\-txospenderindex\fR
217.IP
218Maintain a transaction output spender index, used by the
219gettxspendingprevout rpc call (default: 0)
220.HP
221\fB\-version\fR
222.IP
223Print version and exit
224.PP
225Connection options:
226.HP
227\fB\-addnode=\fR<ip>
228.IP
229Add a node to connect to and attempt to keep the connection open (see
230the addnode RPC help for more info). This option can be specified
231multiple times to add multiple nodes; connections are limited to
2328 at a time and are counted separately from the \fB\-maxconnections\fR
233limit.
234.HP
235\fB\-asmap=\fR<file>
236.IP
237Specify asn mapping used for bucketing of the peers. Relative paths will
238be prefixed by the net\-specific datadir location. If a bool arg
239is given (\fB\-asmap\fR or \fB\-asmap\fR=\fI\,1\/\fR), the embedded mapping data in the
240binary will be used.
241.HP
242\fB\-bantime=\fR<n>
243.IP
244Default duration (in seconds) of manually configured bans (default:
24586400)
246.HP
247\fB\-bind=\fR<addr>[:<port>][=onion]
248.IP
249Bind to given address and always listen on it (default: 0.0.0.0). Use
250[host]:port notation for IPv6. Append =onion to tag any incoming