{"last_commit_sha":"1b7222063bfe985b2af44ebe188534527127d072","persisted":true,"title":"Install SchildiChat Desktop","content":"_This guide has been tested with Tails OS version **5.14**_ ## Persistent Storage If you want to keep SchildiChat-Desktop persistent, we need to set up the Persistent storage accordingly: (if you want to use SchildiChat-Desktop only once and lose everything after shutdown/reboot skip to section [Install](#Install)) 0. Make sure you are using an up to date Tails OS, check out https://tails.boum.org/doc/upgrade/. 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 ▸ 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 SchildiChat-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\n/home/amnesia/.local/share/applications source=applications' /live/persistence/TailsData_unlocked/persistence.conf ~~~ 7. Shutdown Tails. ## Install ### Flatpak 0. If you already have Flatpak installed with Flathub repo configured, skip to [SchildiChat Desktop](#SchildiChat-desktop) 1. Start your Tails with persistent storage unlocked and setup an administration password, follow section _Set up an administration password_ at https://tails.boum.org/doc/first_steps/welcome_screen/administration_password/. 2. Choose Applications ▸ System Tools ▸ Terminal 3. Install the package manager Flatpak with executing ~~~ sudo apt update && sudo apt install flatpak xdg-desktop-portal-gtk ~~~ 4. Make the installation persistent (_Install every time_) following step 3. at https://tails.boum.org/doc/persistent_storage/additional_software/#index4h2 5. No we add the Flathub repository to Flatpak, executing ~~~ torify flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo ~~~ Ignore _WARNING torsocks[33952]: [syscall] Unsupported syscall number 315._ ### SchildiChat-Desktop 1. Using the Terminal install SchildiChat-desktop, executing ~~~ torify flatpak install flathub chat.schildi.desktop ~~~ and confirm with ~~~ Y ~~~ 2. For running SchildiChat-desktop on Tails via Tor and access to audio devices, we need to set parameters running SchildiChat-desktop.

Further details

Outside the unsafe browser, Tails is configured to limit network use to the Tor network only. Therefore we need to tell Schildi-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`.

This can be achieved using an executable shell script + creating a desktop file for a more convenient launch of SchildiChat, executing: ~~~ echo -e '#!/bin/sh\nflatpak run chat.schildi.desktop --proxy-server=socks5://127.0.0.1:9050' | tee -a /home/amnesia/Persistent/schildichat-desktop.sh && chmod +x /home/amnesia/Persistent/schildichat-desktop.sh && echo -e '[Desktop Entry]\nType=Application\nName=SchildiChat\nExec=bash -c '\''/home/amnesia/Persistent/schildichat-desktop.sh'\''\nTerminal=true\nCategories=Network\nMimeType=x-scheme-handler/element;\nStartupWMClass=element\nKeywords=Matrix;SchildiChat' | tee -a ~/.local/share/applications/SchildiChat.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' | tee -a /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 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 `SchildiChat` and click the icon to start.

Alternatively via commandline:

1. Start Tails with persistent storage unlocked. 2. Wait until additional software is installed successfully. 3. Choose Applications ▸ System Tools ▸ Terminal 4. Execute: ~~~ Persistent/schildichat-desktop.sh ~~~

### 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 ~~~

Alternatively via commandline:

","front_matter":{},"format":"markdown","uploads_path":"https://0xacab.org/api/v4/projects/4731/wikis/attachments","slug":"matrix/Install-SchildiChat-Desktop","path":"/about.privacy/messengers-on-tails-os/-/wikis/matrix/Install-SchildiChat-Desktop","wiki_path":"/about.privacy/messengers-on-tails-os/-/wikis/home","help_path":"/help/user/project/wiki/_index.md","markdown_help_path":"/help/user/markdown.md","markdown_preview_path":"/about.privacy/messengers-on-tails-os/-/wikis/matrix/Install-SchildiChat-Desktop/preview_markdown","create_path":"/about.privacy/messengers-on-tails-os/-/wikis"}

Admin message