Changes

Page history
Update Install telegram desktop authored by about:privacy's avatar about:privacy
Hide whitespace changes
Inline Side-by-side
Telegram/Install-telegram-desktop.md
View page @ d99aee1b
_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 ## Persistent Storage
If you want to keep Telegram Desktop persistent, we need to set up the Persisent storage accordingly: (if you want to use Telegram Desktop only once and lose everything after shutdown/reboot skip to section [Install](#Install)) If you want to keep Telegram Desktop persistent, we need to set up the Persisent storage accordingly: (if you want to use Telegram Desktop only once and lose everything after shutdown/reboot skip to section [Install](#Install))
...@@ -7,13 +7,12 @@ If you want to keep Telegram Desktop persistent, we need to set up the Persisent ...@@ -7,13 +7,12 @@ If you want to keep Telegram Desktop persistent, we need to set up the Persisent
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 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. 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/. 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 4. Choose _Applications ▸ System Tools ▸ Root Terminal_ using the password set in step 3.
5. Get root privileges with executing `sudo -i` use the password set in step 3. 5. 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
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\ /live/persistence/TailsData_unlocked/persistence.conf\n/home/amnesia/.var/app source=var_app' sed -i '$ a /home/amnesia/.local/share/flatpak source=flatpak\ /live/persistence/TailsData_unlocked/persistence.conf\n/home/amnesia/.var/app source=var_app'
~~~ ~~~
7. Shutdown Tails. 6. Shutdown Tails.
## Install ## Install
### Flatpak ### Flatpak
...@@ -33,20 +32,31 @@ torify flatpak remote-add --user --if-not-exists flathub https://flathub.org/rep ...@@ -33,20 +32,31 @@ torify flatpak remote-add --user --if-not-exists flathub https://flathub.org/rep
Ignore _WARNING torsocks[33952]: [syscall] Unsupported syscall number 315._ Ignore _WARNING torsocks[33952]: [syscall] Unsupported syscall number 315._
### Telegram-Desktop ### Telegram-Desktop
1. Using the Terminal install telegram-desktop, executing `torify flatpak install flathub org.telegram.desktop` and confirm with `Y`. 1. Using the Terminal install telegram-desktop, executing
2. For running telegram-desktop its convenient using an executable shell script, create it executing
~~~ ~~~
echo -e '#!/bin/sh\nflatpak run org.telegram.desktop' | tee -a /home/amnesia/Persistent/telegram-desktop.sh && chmod +x /home/amnesia/Persistent/telegram-desktop.sh torify flatpak install flathub org.telegram.desktop
~~~ ~~~
and confirm with
~~~
Y
~~~
2. For running telegram-desktop on Tails we need to run a command, this can be simplified using an executable shell script + creating a desktop file for a more convenient launch of Telegram, executing:
~~~
echo -e '#!/bin/sh\nflatpak run org.telegram.desktop | sudo tee -a /home/amnesia/Persistent/telegram-desktop.sh && chmod +x /home/amnesia/Persistent/telegram-desktop.sh && echo -e '[Desktop Entry]\nType=Application\nName=Telegram\nIcon=/home/amnesia/.local/share/flatpak/app/org.telegram.desktop/current/active/files/share/icons/hicolor/128x128/apps/org.telegram.desktop.png\nExec=bash -c '\''/home/amnesia/Persistent/telegram-desktop.sh'\''\nTerminal=true\nCategories=Network\nMimeType=x-scheme-handler/element;\nStartupWMClass=telegram\nKeywords=Telegram;' | tee -a ~/.local/share/applications/Telegram.desktop
~~~
4. If you haven't done it already while installing another Flatpak from this HowTo, create an update script and Desktop shortcut for conveniently updating Flatpak managed applications, executing:
~~~
echo -e '#!/bin/sh\n torify flatpak update' | /home/amnesia/Persistent/flatpak-update.sh && chmod a+x /home/amnesia/Persistent/flatpak-update.sh && echo -e '[Desktop Entry]\nType=Application\nName=Flatpak-Update\nExec=bash -c '\''/home/amnesia/Persistent/flatpak-update.sh'\''\nTerminal=true\nCategories=Network\nMimeType=x-scheme-handler/element;\nStartupWMClass=flatpak\nKeywords=flatpak;update;' | tee -a ~/.local/share/applications/Flatpak-Update.desktop
~~~
### Start ### Start
1. Start Tails with persistent storage unlocked. 1. Start Tails with persistent storage unlocked.
2. Choose Applications ▸ System Tools ▸ Terminal 2. Wait until additional software is installed successfully.
3. Execute `Persistent/telegram-desktop.sh` 3. Go to [Activities Overview](https://tails.boum.org/doc/first_steps/desktop/index.en.html#activities), type `Telegram` and click the icon to start.
#### First time start #### First time start
4. Outside the unsafe browser, Tails is configured to limit network use to the Tor network only. Therefore we need to tell telegram-desktop to use [Tor's SOCKS proxy](https://tails.boum.org/contribute/design/stream_isolation/#Implementation). Click the protective shield icon on the left or Settings▸Advanced Options▸Proxy Settings. 4. Outside the unsafe browser, Tails is configured to limit network use to the Tor network only. Therefore we need to tell telegram-desktop to use [Tor's SOCKS proxy](https://tails.boum.org/contribute/design/stream_isolation/#Implementation). Click the protective shield icon on the left or Settings▸Advanced Options▸Proxy Settings.
5. Click the _Connection Type_ button and choose the _Custom Proxy/Add Proxy_ option. 5. Click the _Connection Type_ button and choose the _Custom Proxy/Add Proxy_ option.
6. Select _SOCKS5_ 6. Select _SOCKS5_
7. Fill in Hostname `127.0.0.1` and port `9050`. 7. Fill in Hostname `127.0.0.1` and port `9050`.
8. Select newly created proxy and save the settings. 8. Select newly created proxy and save the settings.
9. Continue with registartion. 9. Continue with registration.
\ No newline at end of file \ No newline at end of file