{{Header}}
{{#seo:
|description=How-To: Use Session Private Messenger with {{project_name_long}}.
|image=Session-private-messenger-thumb.png
}}
{{title|title=
Use Session Session Private Messenger Chat with {{project_name_short}}
}}
[[File:session-private-messenger-logo.webp|thumb|<code>Session</code> Private Messenger Logo]]
{{intro|
How-To: Use Session Private Messenger with {{project_name_short}}.
}}
= Introduction =
{{stub}}

= Session Private Messenger Security =
* [https://github.com/oxen-io/session-desktop/issues/2321 session private messenger does not consider supply chain attacks yet? #2321]
* [https://github.com/oxen-io/session-desktop/issues/2322 security: NPM found 91 vulnerabilities #2322]
* Full discussion and more tickets can be found [https://forums.whonix.org/t/session-private-messenger/13264 here].

= Install the Session Desktop Client =
{{Third_Party_Repository}}

* [[{{Non_q_project_name_short}}|{{non_q_project_name_long}}]]: Perform these steps inside {{project_name_short}}.
* [[{{q_project_name_short}}|{{q_project_name_long}}]]: Perform these steps inside Qubes <code>{{project_name_workstation_template}}</code> Template.

{{Box|text=
'''1.''' Add the Session GPG key to the APT keyrings. <ref>
https://github.com/oxen-io/session-desktop/issues/1397#issuecomment-754945698
</ref>

{{apt_key_add_derivative
|download_command=scurl https://deb.loki.network/pub.gpg --output loki.gpg
|download_command_qubes_templatevm=http_proxy=http://127.0.0.1:8082 https_proxy=http://127.0.0.1:8082 scurl https://deb.loki.network/pub.gpg --output loki.gpg
|source_filename=loki.gpg
|target_filename=/usr/share/keyrings/loki.gpg
|gpg_fingerprint=Key fingerprint = TODO <ref>
[https://github.com/oxen-io/session-desktop/issues/2309 publish OpenPGP / gpg fingerprint of APT signing key #2309]

<pre>
6636 1D8E 3C96 E41C 6DCB  7051 C499 2CE7 A88D 4262
</pre>
</ref>
}}

'''2.''' Add the Session third-party APT repository. <ref>
See [[Advanced_Host_Security#apt-transport-tor|this]] for a comment why <code>tor+</code> is useful even inside {{project_name_short}}.
</ref>

{{CodeSelect|code=
echo 'deb [signed-by=/usr/share/keyrings/loki.gpg] tor+https://deb.loki.network {{Stable project version based on Debian codename}} main' {{!}} sudo tee /etc/apt/sources.list.d/loki.list
}}

'''3.''' Install Session.

{{Install Package|
package=session-desktop
}}

'''4.''' Done.

The process of installing Session is complete.

'''5.''' Note.

* {{non_q_project_name_short}}: No extra steps required.
* {{q_project_name_short}}: Shutdown <code>{{project_name_workstation_template}}</code> Template. Restart {{project_name_workstation_long}} (<code>{{project_name_workstation_vm}}</code> App Qube).
}}

= Usage =

{{CodeSelect|code=
session-desktop
}}

= Footnotes =
{{reflist|close=1}}
{{Footer}}
[[Category:Documentation]]