Running Bisq on Tails - Revision history

SuddenWhipVapor: /* Create installation script */

2024-06-02T18:15:43Z

Create installation script

SuddenWhipVapor at 19:26, 26 July 2023

2023-07-26T19:26:54Z

SuddenWhipVapor at 20:57, 24 April 2023

2023-04-24T20:57:51Z

SuddenWhipVapor: update to last edits suggested by HeadsAndTails at https://bisq.community/t/bisq-on-tails-wiki-needs-updating/11764/15

2023-04-20T21:21:35Z

update to last edits suggested by HeadsAndTails at https://bisq.community/t/bisq-on-tails-wiki-needs-updating/11764/15

Show changes

W000000t: /* Persistent Data Directory */

2023-03-10T09:16:44Z

Persistent Data Directory

W000000t: uploaded changes by HeadsAndTails from bisq.community

2023-03-01T17:21:18Z

uploaded changes by HeadsAndTails from bisq.community

Show changes

MwithM: /* Configure */ fix error

2022-11-29T15:43:19Z

Configure: fix error

MwithM: /* Installation Script */ format

2022-11-29T15:37:27Z

Installation Script: format

MwithM: /* Persistent Data Directory */ Remove repeated link

2022-11-29T15:33:19Z

Persistent Data Directory: Remove repeated link

MwithM: Persistance as per forum suggestion https://bisq.community/t/bisq-on-tails-wiki-needs-updating/11764

2022-11-29T15:31:17Z

Persistance as per forum suggestion https://bisq.community/t/bisq-on-tails-wiki-needs-updating/11764

@@ Line 71: / Line 71: @@
        - 'SAFECOOKIE .*'
      SETEVENTS:
        - 'CIRC ORCONN INFO NOTICE WARN ERR HS_DESC HS_DESC_CONTENT'
      GETINFO:
        - 'net/listeners/socks'
      ADD_ONION:

@@ Line 118: / Line 118: @@
 systemctl restart onion-grater.service
 echo "Edit Bisq executable file ..."
-sed -i 's+Exec=/opt/bisq/bin/Bisq+Exec=/opt/bisq/bin/Bisq --torControlPort 9051 --torControlCookieFile=/var/run/tor/control.authcookie --torControlUseSafeCookieAuth+' /usr/share/applications/bisq-Bisq.desktop
+sed -i 's+Exec=/opt/bisq/bin/Bisq+Exec=/opt/bisq/bin/Bisq --torControlPort 951 --torControlCookieFile=/var/run/tor/control.authcookie --torControlUseSafeCookieAuth+' /usr/share/applications/bisq-Bisq.desktop
 echo "Redirect user data to Tails Persistent Storage ..."
 ln -s $DataDirectory /home/amnesia/.local/share/Bisq
@@ Line 138: / Line 138: @@
 *<code>Applications</code> > <code>Internet</code> > <code>Bisq</code>
 Or via terminal:
-*<code>/opt/bisq/bin/Bisq --torControlPort 9051 --torControlCookieFile=/var/run/tor/control.authcookie --torControlUseSafeCookieAuth</code>
+*<code>/opt/bisq/bin/Bisq --torControlPort 951 --torControlCookieFile=/var/run/tor/control.authcookie --torControlUseSafeCookieAuth</code>
 == Maintenance ==

@@ Line 2: / Line 2: @@
 == Overview ==
+Unlike most operating systems, [https://tails.boum.org/about/ Tails runs ''entirely'' in memory.] When Tails shuts down, memory contents are deleted, restoring the OS to its original state. Only files saved to the [https://tails.boum.org/doc/persistent_storage/ Persistent Storage] survive a reboot.
 Therefore, Bisq must be reinstalled (and configured) after every boot. More importantly, Bisq's [[data directory|default data directory]] must be relocated to the '''Persistent Storage''' so that your wallet, keys, etc. are not lost every time Tails shuts down.
@@ Line 10: / Line 9: @@
 == Preparations ==
 === Configure Tails ===
-On the Tails [https://tails.boum.org/doc/first_steps/welcome_screen/ Welcome Screen]:
+On the Tails [https://tails.boum.org/doc/first_steps/welcome_screen/ Welcome Screen:]
-* [https://tails.boum.org/doc/first_steps/welcome_screen/administration_password/ Set up an administration password].
+* [https://tails.boum.org/doc/first_steps/welcome_screen/administration_password/ Set up an administration password.]
-* [https://tails.boum.org/doc/persistent_storage/create/ Create Persistent Storage].
+* [https://tails.boum.org/doc/persistent_storage/create/ Create Persistent Storage.]
 Once Persistent Storage has been created, a settings window will open automatically. You can also open it from the desktop menu:  <code>Applications</code> > <code>Tails</code> > <code>Persistent Storage</code>.
@@ Line 29: / Line 27: @@
 ==== Import user data from backup ====
-{{Admonition_Warn|'''WARNING:''' Ensure that the [[#Configure_the_Persistent_Folder|persistent data directory] is EMPTY before importing. Do NOT mix user data from different sessions.}}
+{{Admonition_Warn|'''WARNING:''' Ensure that the [[#Configure_the_Persistent_Folder|persistent data directory]] is EMPTY before importing. Do NOT mix user data from different sessions.}}
-To import user data from a previous Bisq installation or backup, copy it into the [[#Configure_the_Persistent_Folder|persistent data directory]:
+If you wish to import user data from a previous Bisq installation or backup, copy it into the [[#Configure_the_Persistent_Folder|persistent data directory]]:
-:<code>cp -ra /[backupdirectory]/bisq_backup_version001/. /home/amnesia/Persistent/bisq/Bisq/</code>
+*<code>cp -ra /[backupdirectory]/bisq_backup_version001/. /home/amnesia/Persistent/bisq/Bisq/</code>
-N.B. The correct path to your <code>btc_mainnet</code> directory should now be:
+'''N.B.''' The correct path to your <code>btc_mainnet</code> directory should now be:
 :<code>/home/amnesia/Persistent/bisq/Bisq/btc_mainnet</code>
@@ Line 45: / Line 43: @@
 === Create installation script ===
-'''NOTE:''' The script below will install Bisq, configure Tor, and redirect user data to the [[#Configure_the_Persistent_Folder|persistent data directory] (by creating a 'symbolic link'). Every step in the script is explained via 'echo' commands.
+'''NOTE:''' The script below will install Bisq, configure Tor, and redirect user data to the [[#Configure_the_Persistent_Folder|persistent data directory]] (by creating a 'symbolic link'). Every step in the script is explained via 'echo' commands.
 * Create a new script file:
@@ Line 138: / Line 136: @@
 Once Bisq has been installed, you can either start it from the desktop menu:
-:<code>Applications</code> > <code>Internet</code> > <code>Bisq</code>
+*<code>Applications</code> > <code>Internet</code> > <code>Bisq</code>
 Or via terminal:
-:<code>/opt/bisq/bin/Bisq --torControlPort 9051 --torControlCookieFile=/var/run/tor/control.authcookie --torControlUseSafeCookieAuth</code>
+*<code>/opt/bisq/bin/Bisq --torControlPort 9051 --torControlCookieFile=/var/run/tor/control.authcookie --torControlUseSafeCookieAuth</code>
 == Maintenance ==
 === Backup user data ===
@@ Line 159: / Line 156: @@
 To backup, first create a new (empty) directory for the backup, then copy the [[#Configure_the_Persistent_Folder|persistent data directory]]. For example:
-:<code>mkdir /[backupdirectory]/bisq_backup_version001</code>
+*<code>mkdir /[backupdirectory]/bisq_backup_version001</code>
-:<code>cp -ra /home/amnesia/Persistent/bisq/Bisq/. /[backupdirectory]/bisq_backup_version001</code>
+*<code>cp -ra /home/amnesia/Persistent/bisq/Bisq/. /[backupdirectory]/bisq_backup_version001</code>
 === Upgrade Bisq to the latest version ===
 * [[#Download_Bisq|Download Bisq]] to <code>/home/amnesia/Persistent/bisq/</code>

@@ Line 115: / Line 115: @@
 <code>mkdir /home/amnesia/Persistent/bisq/
 mv /path/to/[yourbinaryhere] /home/amnesia/Persistent/bisq/</code>
@@ Line 120: / Line 121: @@
 <code>mkdir /home/amnesia/Persistent/bisq/Bisq/
 ln -s /home/amnesia/Persistent/bisq/Bisq /home/amnesia/.local/share/Bisq</code>

@@ Line 101: / Line 101: @@
 Then restart the <code>onion-grater</code> service with <code>systemctl restart onion-grater.service</code>.
-* In <code>/usr/share/applications/bisq-Bisq.desktop</code>, replace:
+* In <code>/usr/share/applications/Bisq.desktop</code>, replace:
 <pre>Exec=/opt/bisq/bin/Bisq</pre>

@@ Line 222: / Line 222: @@
 Now you might run this script everytime you want to install and run Bisq after a Tails restart:
-<code>sudo ./install-bisq.sh<?code>
+<code>sudo ./install-bisq.sh</code>
 [[Category:Guides]]

@@ Line 121: / Line 121: @@
 == Persistent Data Directory ==
-Either you want a fresh install or you had Bisq installed somewhere else and would like to keep your Bisq user identity and data. In both cases, you need to make sure that the Bisq [[data directory]] doesn't get lost after restarting Tails. Read the official [[Tails docs|https://tails.boum.org/doc/first_steps/persistence/index.en.html#index13h2]] about ''dotfiles'', the feature to enable persistence.
+Either you want a fresh install or you had Bisq installed somewhere else and would like to keep your Bisq user identity and data. In both cases, you need to make sure that the Bisq [[data directory]] doesn't get lost after restarting Tails.
 After the first start, Bisq has automatically created its [[data directory]] in the <code>~/.local/share/Bisq</code> directory and from there it gets deleted after a Tails restart.

@@ Line 99: / Line 99: @@
 </pre>
-Then restart the <code>onion-grater</code> service with <code>service onion-grater restart</code>.
+Then restart the <code>onion-grater</code> service with <code>systemctl restart onion-grater.service</code>.
 * In <code>/usr/share/applications/bisq-Bisq.desktop</code>, replace:
@@ Line 121: / Line 121: @@
 == Persistent Data Directory ==
-Either you want a fresh install or you had Bisq installed somewhere else and would like to keep your Bisq user identity and data. In both cases, you need to make sure that the Bisq [[data directory]] doesn't get lost after restarting Tails.
+Either you want a fresh install or you had Bisq installed somewhere else and would like to keep your Bisq user identity and data. In both cases, you need to make sure that the Bisq [[data directory]] doesn't get lost after restarting Tails. Read the official [[Tails docs|https://tails.boum.org/doc/first_steps/persistence/index.en.html#index13h2]] about ''dotfiles'', the feature to enable persistence.
 After the first start, Bisq has automatically created its [[data directory]] in the <code>~/.local/share/Bisq</code> directory and from there it gets deleted after a Tails restart.
@@ Line 127: / Line 127: @@
 === New User ===
-* Quit Bisq after the first start, once synchronisation and setup are completed
+* Quit Bisq after the first start, once synchronisation and setup are completed.
-* Move the [[data directory]] to the dotfiles [https://tails.boum.org/doc/first_steps/persistence/index.en.html#index13h2]
+* Create persistent file and change file ownership.
-<code>mv ~/.local/share/Bisq/* /live/persistence/TailsData_unlocked/dotfiles/.local/share/Bisq</code>
+<code>sudo mkdir -p /live/persistence/TailsData_unlocked/dotfiles/.local/share/Bisq</code>
 * Restart Tails
-=== Existing User ===
+== Existing user ==
+* Close Bisq, then run:
-* Copy your backup of the Bisq [[data directory]] to the dotfiles [https://tails.boum.org/doc/first_steps/persistence/index.en.html#index13h2]
+<code>cp -arnv /home/amnesia/.local/share/Bisq/. /live/persistence/TailsData_unlocked/dotfiles/.local/share/Bisq/</code> <br>
-<code>cp -r /[yourdirectoryhere]/Bisq /live/persistence/TailsData_unlocked/dotfiles/.local/share/Bisq</code>
+*  Close Tails.
 == Installation Script ==