Changes

Page history
Update Install Signal desktop authored by about:privacy's avatar about:privacy
Show whitespace changes
Inline Side-by-side
Signal/Install-Signal-desktop.md
View page @ 2639178e
_This guide has been tested with Tails OS versions **5.9**, **5.10** and **5.11**_
_This guide has been tested with Tails OS versions **5.14**_
## Persistent Storage
If you want to keep Signal Desktop persistent, we need to set up the Persisent storage accordingly: (if you want to use Signal Desktop only once and lose everything after shutdown/reboot skip to section [Install](#Install))
......@@ -7,12 +7,7 @@ If you want to keep Signal Desktop persistent, we need to set up the Persisent s
1. Create persistent storage, follow the steps on https://tails.boum.org/doc/persistent_storage/create/, skip to step 2 if you already have a persistent storage
2. Configure persistent storage with _[Additonal software](https://tails.boum.org/doc/persistent_storage/configure/#index12h2)_ enabled and features according to your other needs (mail, pgp, additional software) follow the steps on https://tails.boum.org/doc/persistent_storage/configure/, skip to step 3 if you already have configured your persistent storage with _additional software_ enabled.
3. (Re)start your Tails and setup an administration password, follow section _Set up an administration password_ at https://tails.boum.org/doc/first_steps/welcome_screen/administration_password/.
4. Choose Applications ▸ System Tools ▸ Terminal
5. Get root privileges with executing
~~~
sudo -i
~~~
use the password set in step 3.
4. Choose _Applications ▸ System Tools ▸ Root Terminal _ and use the password set in step 3.
6. In order to create persistent storage for [Flatpak](https://flatpak.org), a package manager we're going to use for installing Signal Desktop and keeping the software, settings, keys, messages etc. persistent, execute
~~~
sed -i '$ a /home/amnesia/.local/share/flatpak source=flatpak\n/home/amnesia/.var/app source=var_app' /live/persistence/TailsData_unlocked/persistence.conf
......@@ -45,19 +40,51 @@ and confirm with
~~~
Y
~~~
2. For running signal-desktop on Tails via Tor and access to audio devices, we need to export values each time before running signal-desktop. <details><summary>Further details</summary> Outside the unsafe browser, Tails is configured to limit network use to the Tor network only. Therefore we need to tell signal-desktop using Tor's SOCKS proxy by exporting `export HTTP_PROXY=socks://127.0.0.1:9050` and `export HTTPS_PROXY=socks://127.0.0.1:9050`. For enabling access to the audio device of the machine running Tails, we need to fix some dbus errors, blocking access to alsa by exporting `export $(dbus-launch)` and `export XDG_RUNTIME_DIR=/run/user/$(id -u)`.</details> This can be achieved using an executable shell script, create it executing
2. For running signal-desktop on Tails via Tor and access to audio devices, we need to export values each time before running signal-desktop. <details><summary>Further details</summary> Outside the unsafe browser, Tails is configured to limit network use to the Tor network only. Therefore we need to tell signal-desktop using Tor's SOCKS proxy by exporting `export HTTP_PROXY=socks://127.0.0.1:9050` and `export HTTPS_PROXY=socks://127.0.0.1:9050`. For enabling access to the audio device of the machine running Tails, we need to fix some dbus errors, blocking access to alsa by exporting `export $(dbus-launch)` and `export XDG_RUNTIME_DIR=/run/user/$(id -u)`.</details> This can be achieved using an executable shell script + creating a desktop file for a more convenient launch of Signal Desktop, execute:
~~~
echo -e '#!/bin/sh\nexport $(dbus-launch)\nexport XDG_RUNTIME_DIR=/run/user/$(id -u)\nexport HTTP_PROXY=socks://127.0.0.1:9050\nexport HTTPS_PROXY=socks://127.0.0.1:9050\nflatpak run org.signal.Signal' | tee -a /home/amnesia/Persistent/signal-desktop.sh && chmod +x /home/amnesia/Persistent/signal-desktop.sh
echo -e '#!/bin/sh\nexport $(dbus-launch)\nexport XDG_RUNTIME_DIR=/run/user/$(id -u)\nexport HTTP_PROXY=socks://127.0.0.1:9050\nexport HTTPS_PROXY=socks://127.0.0.1:9050\nflatpak run org.signal.Signal' | tee -a /home/amnesia/Persistent/signal-desktop.sh && chmod a+x /home/amnesia/Persistent/signal-desktop.sh && echo -e '[Desktop Entry]\nType=Application\nName=Signal Desktop\nIcon=/home/amnesia/.local/share/flatpak/app/org.signal.Signal/current/active/files/share/icons/hicolor/128x128/apps/org.signal.Signal.png\nExec=bash -c '\''/home/amnesia/Persistent/signal-desktop.sh'\''\nTerminal=true\nCategories=Network\nMimeType=x-scheme-handler/signal;\nStartupWMClass=signal\nKeywords=Signal;' | tee -a ~/.local/share/applications/Signal.desktop
~~~
### Start
1. Start Tails with persistent storage unlocked.
2. Choose Applications ▸ System Tools ▸ Terminal
3. Execute:
2. Wait until additional software is installed successfully.
3. Go to [Activities Overview](https://tails.boum.org/doc/first_steps/desktop/index.en.html#activities), type `Signal` and click the icon to start.
<details><summary>Alternatively via commandline:</summary>
1. Start Tails with persistent storage unlocked.
2. Wait until additional software is installed successfully.
3. Choose Applications ▸ System Tools ▸ Terminal
4. Execute:
~~~
Persistent/signal-desktop.sh
~~~
</details>
### Provisioning
1. Starting signal-desktop for the first time or after it had been unlinked by master or after 1 month of inactivity, you need to link your Signal with the master device.
2. If your master Signal device is running Android or iOS, follow the official guide: https://support.signal.org/hc/en-us/articles/360007320551-Linked-Devices if the master is signal-cli, follow [the guide on linking signal-cli with signal-desktop on Tails](../Signal/Registration-and-Provisioning-via-signal-cli)
### Update applications installed via Flatpak
Regularly you should update your applications installed via Flatpak
1. Start Tails with persistent storage unlocked.
2. Wait until additional software is installed successfully.
3. Go to [Activities Overview](https://tails.boum.org/doc/first_steps/desktop/index.en.html#activities), type `Flatpak` and click on `Flatpak-Update` to start.
4. When queried for in the terminal, confirm updates with
~~~
Y
~~~
<details><summary>Alternatively via commandline:</summary>
1. Start Tails with persistent storage unlocked.
2. Wait until additional software is installed successfully.
3. Choose Applications ▸ System Tools ▸ Terminal
4. Execute:
~~~
Persistent/flatpak-update.sh
~~~
5. When queried for in the terminal, confirm updates with
~~~
Y
~~~
</details>