Changing your onion address - Revision history

Strayorigin: Update & clarify guide: Remove outdated Tor v2 deprecation info; focus on privacy motivation; improve warnings (open trades/disputes); clarify backup/generation steps & resource usage; enhance flow; add relevant internal links.

2025-04-15T16:14:16Z

Update & clarify guide: Remove outdated Tor v2 deprecation info; focus on privacy motivation; improve warnings (open trades/disputes); clarify backup/generation steps & resource usage; enhance flow; add relevant internal links.

MwithM: /* Change your Bisq instance's onion address */ Typo

2021-06-30T08:22:41Z

Change your Bisq instance's onion address: Typo

Pazza: /* Things to consider beforehand */

2021-05-06T04:20:23Z

Things to consider beforehand

Pazza: /* Back up your hiddenservices directory */

2021-05-06T04:20:08Z

Back up your hiddenservices directory

Pazza: /* Back up your hiddenservices directory */

2021-05-06T04:19:57Z

Back up your hiddenservices directory

Pazza: /* Change your Bisq instance's onion address */

2021-05-06T04:19:28Z

Change your Bisq instance's onion address

Plebeian9000: put beforehand considerations before everything else

2021-04-08T17:11:03Z

put beforehand considerations before everything else

Plebeian9000: create page explaining how to upgrade bisq onion address

2021-04-08T17:04:09Z

create page explaining how to upgrade bisq onion address

New page

You may want to '''change your onion address''' from time to time for privacy. If your Bisq instance still uses Tor v2, you will want to change your onion address so it uses Tor v3 before Tor v2 becomes unsupported in July 2021.

Note that this article is about the Tor address that your Bisq instance itself uses. This is different from the Tor address of ''other'' hidden services that Bisq connects to, such as Bitcoin nodes. Connecting to Bitcoin nodes running Tor v3 is not supported yet, because bitcoinj doesn't support it yet, but [https://github.com/bitcoinj/bitcoinj/issues/2067 work is underway to enable it].

__TOC__

== Determine which Tor version Bisq is running ==

If you're interested in upgrading your onion address to a Tor v3 address, but not sure which version your Bisq instance is currently running, you can check by going to <code>Settings</code> > <code>Network Info</code>. Scroll down to the section titled "Bisq network", and there you'll see your onion address.

If it's a long 56-character string, then your Bisq instance is already using Tor v3. If it's a shorter 16-character string, then your Bisq instance is still using Tor v2 and should be upgraded.

[[File:Tor-which-version.png|600px|thumb|left|Check which Tor version your Bisq instance is running.]]
<div style="clear: both;"></div>

== Back up your hiddenservices directory ==

'''Make sure to back up your Bisq data directory before changing your onion address.'''

At the very least, make sure the <code>btc_mainnet/tor/hiddenservices</code> directory is backed up, since changing your onion address requires deleting that folder.

== Things to consider beforehand ==

'''If you have any open trades or open disputes, do not change your onion address.''' Doing so will make you unreachable, and thus incapable of ever completing those items and losing funds.

It is fine to have open offers, as Bisq will adjust your offers to become available with the new onion address upon starting up.

This is also why it's so important to back up your <code>hiddenservices</code> folder—it will allow you to revert to your old onion address ''just in case'' you need to re-open a dispute.

{{Admonition_Note|Also take note that changing your onion address will clear your [[local reputation]], since local reputation is based on onion address.}}

== Change your Bisq instance's onion address ==

With all the preparatory considerations out of the way, actually changing your Bisq instance's onion address is very easy.

With Bisq closed, simply delete the <code>hiddenservices</code> folder in your [[data directory]]. Then start Bisq. Bisq will create a new <code>hiddenservices</code> folder with new keys and a new Tor v3 onion address!

@@ Line 1: / Line 1: @@
-You may want to '''change your onion address''' from time to time for privacy. If your Bisq instance still uses Tor v2, you will want to change your onion address so it uses Tor v3 before Tor v2 becomes unsupported in July 2021.
+You may want to '''generate a new Tor onion address''' for your Bisq instance from time to time, primarily as a privacy-enhancing measure. Bisq automatically uses modern Tor v3 addresses (long, 56-character strings). This guide explains the process for forcing Bisq to create a new one.
-Note that this article is about the Tor address that your Bisq instance itself uses. This is different from the Tor address of ''other'' hidden services that Bisq connects to, such as Bitcoin nodes. Connecting to Bitcoin nodes running Tor v3 is not supported yet, because bitcoinj doesn't support it yet, but [https://github.com/bitcoinj/bitcoinj/issues/2067 work is underway to enable it].
+'''Note:''' This process changes the onion address your specific Bisq application uses to connect to the Bisq network (peers). It is different from, and does not affect, the Tor addresses of external services Bisq might connect to (like public [[Connecting to your own Bitcoin node|Bitcoin nodes]]).
 __TOC__
-== Things to consider beforehand ==
+== Important Considerations Before Changing ==
-'''If you have any open trades or open disputes, do not change your onion address.''' Doing so will make you unreachable, and thus incapable of ever completing those items and losing funds.
+'''CRITICAL WARNING: Do NOT change your onion address if you have any open trades or [[Dispute_Resolution_in_Bisq_1|open disputes]].''' Doing so will make your Bisq instance unreachable by your peers in those specific contexts. You will be unable to complete those trades or disputes, likely resulting in loss of funds (security deposits or trade amounts).
-It is fine to have open offers, as Bisq will adjust your offers to become available with the new onion address upon starting up.
+* '''Open offers are OK:''' If you only have open *offers* (not accepted trades), it is safe to proceed. Bisq will automatically update your offers with the new onion address when it restarts.
-This is also why it's so important to back up your <code>hiddenservice</code> folder—it will allow you to revert to your old onion address ''just in case'' you need to re-open a dispute.
+== Checking Your Current Onion Address ==
-{{Admonition_Note|Also take note that changing your onion address will clear your [[local reputation]], since local reputation is based on onion address.}}
+You can verify your current Bisq onion address type:
-== Determine which Tor version Bisq is running ==
+[[File:Tor-which-version.png|600px|thumb|left|Check your current onion address under Settings > Network Info.]]
-If you're interested in upgrading your onion address to a Tor v3 address, but not sure which version your Bisq instance is currently running, you can check by going to <code>Settings</code> > <code>Network Info</code>. Scroll down to the section titled "Bisq network", and there you'll see your onion address.
+== Step 1: Back Up Your `hiddenservice` Directory ==
-If it's a long 56-character string, then your Bisq instance is already using Tor v3. If it's a shorter 16-character string, then your Bisq instance is still using Tor v2 and should be upgraded.
+'''Before proceeding, ensure Bisq is completely closed.'''
-== Back up your hiddenservice directory ==
+Navigate to your [[data directory]]. Find the Tor folder within it, relevant to your operating system and network (e.g., `btc_mainnet/tor/`).
-'''Make sure to back up your Bisq data directory before changing your onion address.'''
+'''Create a safe [[Backing up application data|backup copy]]''' of the entire `hiddenservice` folder found inside that Tor directory. This folder contains the private keys for your current onion address.
-At the very least, make sure the <code>btc_mainnet/tor/hiddenservice</code> directory is backed up, since changing your onion address requires deleting that folder.
+== Step 2: Generate the New Onion Address ==
-== Change your Bisq instance's onion address ==
+With Bisq still closed and the `hiddenservice` folder safely backed up:
-With all the preparatory considerations out of the way, actually changing your Bisq instance's onion address is very easy.
+.  '''Delete''' the original `hiddenservice` folder from your Bisq [[data directory]] (the one inside `btc_mainnet/tor/` or similar).
-With Bisq closed, simply delete the <code>hiddenservice</code> folder in your [[data directory]]. Then restart Bisq. During the next restart Bisq will create a new <code>hiddenservice</code> folder with new keys and a new Tor v3 onion address. This process using a lots of RAM so close down other applications before starting. It might take up to 10 mins and Bisq might be unresponsive during this process, but be patient and leave it running. Once complete you will have a new Tor v3 onion address!
+Remember to create new [[Backing up application data|backups]] that include your new `hiddenservice` folder.

← Older revision		Revision as of 08:22, 30 June 2021
Line 34:		Line 34:
	With all the preparatory considerations out of the way, actually changing your Bisq instance's onion address is very easy.		With all the preparatory considerations out of the way, actually changing your Bisq instance's onion address is very easy.

−	With Bisq closed, simply delete the <code>hiddenservice</code> folder in your [[data directory]]. Then ~~start~~ restart Bisq. During the next restart Bisq will create a new <code>hiddenservice</code> folder with new keys and a new Tor v3 onion address. This process using a lots of RAM so close down other applications before starting. It might take up to 10 mins and Bisq might be unresponsive during this process, but be patient and leave it running. Once complete you will have a new Tor v3 onion address!	+	With Bisq closed, simply delete the <code>hiddenservice</code> folder in your [[data directory]]. Then restart Bisq. During the next restart Bisq will create a new <code>hiddenservice</code> folder with new keys and a new Tor v3 onion address. This process using a lots of RAM so close down other applications before starting. It might take up to 10 mins and Bisq might be unresponsive during this process, but be patient and leave it running. Once complete you will have a new Tor v3 onion address!

← Older revision		Revision as of 04:19, 6 May 2021
Line 34:		Line 34:
	With all the preparatory considerations out of the way, actually changing your Bisq instance's onion address is very easy.		With all the preparatory considerations out of the way, actually changing your Bisq instance's onion address is very easy.

−	With Bisq closed, simply delete the <code>~~hiddenservices~~</code> folder in your [[data directory]]. Then start Bisq. Bisq will create a new <code>~~hiddenservices~~</code> folder with new keys and a new Tor v3 onion address!	+	With Bisq closed, simply delete the <code>hiddenservice</code> folder in your [[data directory]]. Then start restart Bisq. During the next restart Bisq will create a new <code>hiddenservice</code> folder with new keys and a new Tor v3 onion address. This process using a lots of RAM so close down other applications before starting. It might take up to 10 mins and Bisq might be unresponsive during this process, but be patient and leave it running. Once complete you will have a new Tor v3 onion address!

@@ Line 24: / Line 24: @@
 <div style="clear: both;"></div>
-== Back up your hiddenservices directory ==
+== Back up your hiddenservice directory ==
 '''Make sure to back up your Bisq data directory before changing your onion address.'''

@@ Line 4: / Line 4: @@
 __TOC__
 == Determine which Tor version Bisq is running ==
@@ Line 19: / Line 29: @@
 At the very least, make sure the <code>btc_mainnet/tor/hiddenservices</code> directory is backed up, since changing your onion address requires deleting that folder.
 == Change your Bisq instance's onion address ==