Last resort restore
About this page2 migration checks
- Original wiki wording
- rev 3195 · 28 Apr 2023
- 2 migration checks
- Checked 7 Nov 2026 · 1 needs maintainer review
- Automated source comparison, not reviewed by a maintainer
Show checks
Added during migration, not part of the original. Each check identifies a specific difference or review need; none is a review of the whole procedure.
Tor identity path spelling Checked against pinned source
Bisq 1 v1.10.11 defines the directory name as hiddenservice (singular). The Restoring application data source uses hiddenservices (plural). The checked implementation supports btc_mainnet/tor/hiddenservice for this identity path; it does not establish that selectively replacing identity files is safe during an active trade.
Checked 7 Nov 2026
Last resort restore: procedure review Needs maintainer review
The original Last resort restore procedure is restored here, including its file-selection, copy order, identity directories, rollback and SPV-resync directions. The earlier AI edit did not preserve the complete procedure. Support maintainers still need to assess its applicability to the pinned release; restoration of the wording is not a recovery test.
Checked 7 Nov 2026
Sometimes it will happen that your Bisq instance won't start, and you don't have backups, or your backups do not start as well, or are too old to be useful. The following is to be intended as a hacky-workaround-last-resort-attempt to have Bisq start while retaining as much data as possible from the previous installation. In practical terms, it means that if something goes wrong with this guide and your machine explodes, you were warned and are the sole responsible for the event.
Test with a fresh data directory
Section titled “Test with a fresh data directory”First of all, make sure you have the latest version installed, and Bisq is closed (terminate orphan existing processes if any), then rename your data directory by changing Bisq to, for example, Bisq.old.
Start Bisq again: it should start into a 100% new instance, creating a brand new Bisq folder (if it doesn't, try uninstalling and then reinstalling Bisq).
Close Bisq again: we are going to use the freshly created Data Directory as a stump to populate with our old data.
Import raw data from backup
Section titled “Import raw data from backup”Open your renamed folder, get into the btc_mainnet/db folder, and sort files by "last modified" descending, you are looking for those files that were modified most recently, all of them in the same day (presumably the last day your Bisq was operational).
The list should include:
BsqSwapTrades
DisputeList
RefundDisputeList
SequenceNumberMap
MyVoteList
OpenOffers
MyBlindVoteList
ClosedTrades
MediationDisputeList
MyProposalList
MailboxMessageList
AccountAgeWitnessStore
PendingTrades
MyProofOfBurnList
PreferencesPayload
UserPayload
AddressEntryList
FailedTrades
MyReputationList
TempProposalStore
NavigationPath
UnconfirmedBsqChangeOutputList
IgnoredMailboxMap
PeerList
RemovedPayloadsMap
TradeStatistics3Store
SignedWitnessStore
Copy all the above files in the corresponding btc_mainnet/db folder of your fresh data directory, overwriting the existing ones.
Then, delete from the fresh data directory, and replace with copies from the old directory, the following folders:
btc_mainnet/keys
btc_mainnet/wallet
btc_mainnet/tor/hiddenservice
Cross your fingers, and start Bisq again hoping that everything, including the state of trades and disputes, has been restored; if not, this is a reversible step as you can simply restore the existing old folder after deleting the fresh one you created.
If anything is off with the wallet balances shown by Bisq after this restore, you can try a SPV resync (or more)
Source and history
This article keeps its recovered wording, headings, step order and available images. Formatting and links are adapted for this site. The snapshot does not guarantee that every instruction is current.
- Original page
- Last resort restore
- Revision
- 3195 · 28 Apr 2023
- Last recorded editor
- SuddenWhipVapor (not a complete author list)
- Snapshot
- 18 October 2026
- Source files
- Original wikitext · Revision metadata
- Recovery gaps
- 0 restored historical template occurrences · 0 unresolved templates · 0 unresolved article links · 0 unresolved sections