deploy: 45b7d09f83
This commit is contained in:
@@ -402,7 +402,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
<h2 id="customize-and-share-color-themes" tabindex="-1">Customize and share color themes</h2>
|
||||
<img src="./images/20230523-theme.png" width="288">
|
||||
<p>Android app now allows choosing between three color themes - Light, Dark and SimpleX (a dark blue theme). You can customize any theme by setting 9 different colors used in the app, including titles, menus, accent colors and colors for sent and received messages.</p>
|
||||
<p>You can share your theme with other users by exporting it to a file and sending to them. You can also <a href="docs/THEMES.html">contribute your favorite themes</a> to our GitHub repository.</p>
|
||||
<p>You can share your theme with other users by exporting it to a file and sending to them. You can also <a href="docs/themes.html">contribute your favorite themes</a> to our GitHub repository.</p>
|
||||
<h2 id="self-destruct-passcode" tabindex="-1">Self-destruct passcode</h2>
|
||||
<img src="./images/20230523-self-destruct.png" width="288">
|
||||
<p>This is something many of you asked before - when asked to enter the app passcode under duress, to be able to enter a special self-destruct code that would remove the app data. This feature is offered in many security tools, and now you can configure it in SimpleX Chat as well.</p>
|
||||
|
||||
@@ -417,8 +417,8 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
<p>Please report the cases when messages are not delivered – delivery receipts should help with that.</p>
|
||||
<h4 id="messages-failed-to-decrypt-problem-solved" tabindex="-1">Messages failed to decrypt? Problem solved!</h4>
|
||||
<p>Previously, a growing number of users had the issue when after restoring the chat database from backup, messages from some contacts failed to decrypt and were showing an error in the app.</p>
|
||||
<p>This happens due to double ratchet protocol protecting the integrity of end-to-end encryption after the compromise - <a href="docs/GLOSSARY.html#post-compromise-security">post-compromise security</a>. The protocol logic does not allow to use the old version of the database to decrypt the message.</p>
|
||||
<p>v5.2 added the extension to the messaging protocol allowing to negotiate the new ratchet keys in such cases - both with the contacts and the group members. This requires a user action, and it resets the security code verification status for this contact or member – you need to verify it again to have the additional protection from <a href="docs/GLOSSARY.html#man-in-the-middle-attack">man-in-the-middle attacks</a>.</p>
|
||||
<p>This happens due to double ratchet protocol protecting the integrity of end-to-end encryption after the compromise - <a href="docs/glossary.html#post-compromise-security">post-compromise security</a>. The protocol logic does not allow to use the old version of the database to decrypt the message.</p>
|
||||
<p>v5.2 added the extension to the messaging protocol allowing to negotiate the new ratchet keys in such cases - both with the contacts and the group members. This requires a user action, and it resets the security code verification status for this contact or member – you need to verify it again to have the additional protection from <a href="docs/glossary.html#man-in-the-middle-attack">man-in-the-middle attacks</a>.</p>
|
||||
<p>The negotiation of the new ratchet keys still happens via the end-to-end encrypted messages, as the protocol has two layers of end-to-end encryption, so it cannot be compromised by the messaging relays.</p>
|
||||
<p>You may still lose connection if you or your contact changed the receiving address after you made the backup, so make sure to make a new backup after any receiving address changes.</p>
|
||||
<h4 id="reconnect-the-servers" tabindex="-1">Reconnect the servers</h4>
|
||||
|
||||
@@ -738,7 +738,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| 07.02.2023 | EN, <a href="/docs/lang/cs/ANDROID.html">CZ</a>, <a href="/docs/lang/fr/ANDROID.html">FR</a> |</p>
|
||||
<div><p>| 07.02.2023 | EN, <a href="/docs/lang/cs/android.html">CZ</a>, <a href="/docs/lang/fr/android.html">FR</a> |</p>
|
||||
<h1 id="accessing-files-in-android-app" tabindex="-1">Accessing files in Android app</h1>
|
||||
<p>SimpleX uses databases and stores its preferences inside private data directory in Android. The directory contains:</p>
|
||||
<ul>
|
||||
@@ -771,7 +771,7 @@ tar -xvzf chat.gz
|
||||
<p>After that the backup should be ended. If you see an error saying <code>tar: Error is not recoverable: exiting now</code> but before that you have printed some file names, don't worry, it's ok.</p>
|
||||
<p>Now the backed-up files will be inside <code>./apps/chat.simplex.app/</code>.</p>
|
||||
<p>Please, note, that if you use a modern version of SimpleX, the databases will be encrypted, and you'll not be able to view contents of them without using <code>sqlcipher</code> application and without knowing decryption passphrase (you need to change it to yours from randomly generated in the app firstly).</p>
|
||||
<p>Please, follow <a href="SQL.html">SQL.md</a> guide for more info of how to decrypt your databases and to make queries to them.</p>
|
||||
<p>Please, follow <a href="sql.html">SQL.md</a> guide for more info of how to decrypt your databases and to make queries to them.</p>
|
||||
</div>
|
||||
</article>
|
||||
</main>
|
||||
|
||||
@@ -738,7 +738,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Updated 31.01.2023 | Languages: EN, <a href="/docs/lang/fr/CLI.html">FR</a>, <a href="/docs/lang/cs/CLI.html">CZ</a> |</p>
|
||||
<div><p>| Updated 31.01.2023 | Languages: EN, <a href="/docs/lang/fr/cli.html">FR</a>, <a href="/docs/lang/cs/cli.html">CZ</a> |</p>
|
||||
<h1 id="simplex-chat-terminal-console-app-for-linuxmacoswindows" tabindex="-1">SimpleX Chat terminal (console) app for Linux/MacOS/Windows</h1>
|
||||
<h2 id="table-of-contents" tabindex="-1">Table of contents</h2>
|
||||
<ul>
|
||||
@@ -904,7 +904,7 @@ brew services start tor
|
||||
<p>Open SQLite Command Line Shell:</p>
|
||||
<pre><code class="language-sh">sqlite3 ~/.simplex/simplex_v1_chat.db
|
||||
</code></pre>
|
||||
<p>See <a href="SQL.html">Message queries</a> for examples.</p>
|
||||
<p>See <a href="sql.html">Message queries</a> for examples.</p>
|
||||
<blockquote>
|
||||
<p><strong>Please note:</strong> SQLite foreign key constraints are disabled by default, and must be <strong><a href="https://sqlite.org/foreignkeys.html#fk_enable">enabled separately for each database connection</a></strong>. The latter can be achieved by running <code>PRAGMA foreign_keys = ON;</code> command on an open database connection. By running data altering queries without enabling foreign keys prior to that, you may risk putting your database in an inconsistent state.</p>
|
||||
</blockquote>
|
||||
|
||||
@@ -738,7 +738,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Updated 31.01.2023 | Languages: EN, <a href="/docs/lang/fr/CONTRIBUTING.html">FR</a>, <a href="/docs/lang/cs/CONTRIBUTING.html">CZ</a> |</p>
|
||||
<div><p>| Updated 31.01.2023 | Languages: EN, <a href="/docs/lang/fr/contributing.html">FR</a>, <a href="/docs/lang/cs/contributing.html">CZ</a> |</p>
|
||||
<h1 id="contributing-guide" tabindex="-1">Contributing guide</h1>
|
||||
<h2 id="compiling-with-sqlcipher-encryption-enabled" tabindex="-1">Compiling with SQLCipher encryption enabled</h2>
|
||||
<p>Add <code>cabal.project.local</code> to project root with the location of OpenSSL headers and libraries and flag setting encryption mode:</p>
|
||||
|
||||
@@ -744,7 +744,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
<p>In the context of SimpleX network, these are the identifiers generated by SMP relays to access anonymous messaging queues, with a separate identifier (and access credential) for each accessing party: recipient, sender and and optional notifications subscriber. The same approach is used by XFTP relays to access file chunks, with separate identifiers (and access credentials) for sender and each recipient.</p>
|
||||
<h2 id="peer-to-peer" tabindex="-1">Peer-to-peer</h2>
|
||||
<p>Peer-to-peer (P2P) is the network architecture when participants have equal rights and communicate directly via a general purpose transport or overlay network. Unlike client-server architecture, all peers in a P2P network both provide and consume the resources. In the context of messaging, P2P architecture usually means that the messages are sent between peers, without user accounts or messages being stored on any servers. Examples are Tox, Briar, Cwtch and many others.</p>
|
||||
<p>The advantage is that the participants do not depend on any servers. There are <a href="SIMPLEX.html#comparison-with-p2p9-messaging-protocols">multiple downsides</a> to that architecture, such as no asynchronous message delivery, the need for network-wide peer addresses, possibility of network-wide attacks, that are usually mitigated only by using a centralized authority. These disadvantages are avoided with <a href="#proxied-peer-to-peer">proxied P2P</a> architecture.</p>
|
||||
<p>The advantage is that the participants do not depend on any servers. There are <a href="simplex.html#comparison-with-p2p9-messaging-protocols">multiple downsides</a> to that architecture, such as no asynchronous message delivery, the need for network-wide peer addresses, possibility of network-wide attacks, that are usually mitigated only by using a centralized authority. These disadvantages are avoided with <a href="#proxied-peer-to-peer">proxied P2P</a> architecture.</p>
|
||||
<p><a href="https://en.wikipedia.org/wiki/Peer-to-peer">Wikipedia</a>.</p>
|
||||
<h2 id="perfect-forward-secrecy" tabindex="-1">Perfect forward secrecy</h2>
|
||||
<p><a href="#forward-secrecy">Forward secrecy</a>.</p>
|
||||
|
||||
@@ -672,7 +672,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
<p>This section is labelled <strong>"You"</strong> in the app settings.</p>
|
||||
<h3 id="your-active-profile" tabindex="-1">Your active profile</h3>
|
||||
<p>Tap on your avatar/name to update your current profile names and avatar.</p>
|
||||
<p>Display name cannot have any spaces and it is recommended to use latin characters and numbers to make it easier to type these names to the users who use <a href="CLI.html">SimpleX Chat for the terminal</a> (CLI).</p>
|
||||
<p>Display name cannot have any spaces and it is recommended to use latin characters and numbers to make it easier to type these names to the users who use <a href="cli.html">SimpleX Chat for the terminal</a> (CLI).</p>
|
||||
<p><strong>Please note</strong>: When you save your profile, the update will be sent to all your contacts (excluding the contacts with whom your incognito profiles were shared). If you have a large number of contacts it can take several seconds.</p>
|
||||
<h3 id="your-chat-profiles" tabindex="-1">Your chat profiles</h3>
|
||||
<p>This page allows adding and configuring your chat profiles. Please see <a href="chat-profiles.html">Your chat profiles</a> for more details.</p>
|
||||
|
||||
@@ -695,7 +695,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
<li>Tap on "Send questions and ideas".</li>
|
||||
</ul>
|
||||
<h3 id="join-some-user-groups" tabindex="-1">Join some user groups</h3>
|
||||
<p>There are links to join several <a href="README.html#join-user-groups">user groups</a> on our GitHub page - join them to ask any questions and discuss ideas.</p>
|
||||
<p>There are links to join several <a href="readme.html#join-user-groups">user groups</a> on our GitHub page - join them to ask any questions and discuss ideas.</p>
|
||||
<p>You can also find some other user-managed groups via online search.</p>
|
||||
<p>To join a group via a link:</p>
|
||||
<ul>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Aktualizováno 07.02.2023 | Jazyky: CZ, <a href="/docs/ANDROID.html">EN</a> |</p>
|
||||
<div><p>| Aktualizováno 07.02.2023 | Jazyky: CZ, <a href="/docs/android.html">EN</a> |</p>
|
||||
<h1 id="pristup-k-souborum-v-aplikaci-android" tabindex="-1">Přístup k souborům v aplikaci Android</h1>
|
||||
<p>SimpleX používá databáze a ukládá své předvolby do soukromého datového adresáře v systému Android. Adresář obsahuje:</p>
|
||||
<ul>
|
||||
@@ -759,7 +759,7 @@ tar -xvzf chat.gz
|
||||
<p>Poté by mělo být zálohování ukončeno. Pokud se zobrazí chybové hlášení <code>tar: Error is not recoverable: exiting now</code>, ale předtím jste vypsali názvy některých souborů, nebojte se, je to v pořádku.</p>
|
||||
<p>Nyní budou zálohované soubory uvnitř <code>./apps/chat.simplex.app/</code>.</p>
|
||||
<p>Upozorňujeme, že pokud používáte moderní verzi SimpleX, budou databáze zašifrované a jejich obsah nebudete moci zobrazit bez použití aplikace <code>sqlcipher</code> a bez znalosti dešifrovací fráze (musíte ji nejprve změnit na svou z náhodně vygenerovaných v aplikaci).</p>
|
||||
<p>Další informace o tom, jak dešifrovat databáze a provádět dotazy do nich, najdete v příručce <a href="SQL.html">SQL.md</a>.</p>
|
||||
<p>Další informace o tom, jak dešifrovat databáze a provádět dotazy do nich, najdete v příručce <a href="sql.html">SQL.md</a>.</p>
|
||||
</div>
|
||||
</article>
|
||||
</main>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Aktualizováno 31.01.2023 | Jazyky: CZ, <a href="/docs/CLI.html">EN</a>, <a href="/docs/lang/fr/CLI.html">FR</a> |</p>
|
||||
<div><p>| Aktualizováno 31.01.2023 | Jazyky: CZ, <a href="/docs/cli.html">EN</a>, <a href="/docs/lang/fr/cli.html">FR</a> |</p>
|
||||
<h1 id="simplex-chat-terminalova-konzolova-aplikace-pro-linuxmacoswindows" tabindex="-1">SimpleX Chat terminálová (konzolová) aplikace pro Linux/MacOS/Windows</h1>
|
||||
<h2 id="obsah" tabindex="-1">Obsah</h2>
|
||||
<ul>
|
||||
@@ -892,7 +892,7 @@ brew services start tor
|
||||
<p>Otevřete SQLite Command Line Shell:</p>
|
||||
<pre><code class="language-sh">sqlite3 ~/.simplex/simplex_v1_chat.db
|
||||
</code></pre>
|
||||
<p>Příklady viz <a href="SQL.html">Message queries</a>.</p>
|
||||
<p>Příklady viz <a href="sql.html">Message queries</a>.</p>
|
||||
<blockquote>
|
||||
<p><strong>Upozornění:</strong> Omezení cizích klíčů SQLite jsou ve výchozím nastavení vypnuta a musí být <strong><a href="https://sqlite.org/foreignkeys.html#fk_enable">povolena pro každé připojení k databázi zvlášť</a></strong>. Toho lze dosáhnout spuštěním příkazu <code>PRAGMA foreign_keys = ON;</code> na otevřeném databázovém připojení. Spouštěním dotazů měnících data bez předchozího povolení cizích klíčů můžete riskovat, že se databáze dostane do nekonzistentního stavu.</p>
|
||||
</blockquote>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Aktualizováno 31.01.2023 | Jazyky: CZ, <a href="/docs/CONTRIBUTING.html">EN</a>, <a href="/docs/lang/fr/CONTRIBUTING.html">FR</a> |</p>
|
||||
<div><p>| Aktualizováno 31.01.2023 | Jazyky: CZ, <a href="/docs/contributing.html">EN</a>, <a href="/docs/lang/fr/contributing.html">FR</a> |</p>
|
||||
<h1 id="pruvodce-prispivanim" tabindex="-1">Průvodce přispíváním</h1>
|
||||
<h2 id="kompilace-s-povolenym-sifrovanim-sqlcipher" tabindex="-1">Kompilace s povoleným šifrováním SQLCipher</h2>
|
||||
<p>Do kořenového adresáře projektu přidejte <code>cabal.project.local</code> s umístěním hlaviček a knihoven OpenSSL a příznakem nastavujícím režim šifrování:</p>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Aktualizováno 05.06.2023 | Jazyky: CZ, <a href="/docs/SERVER.html">EN</a>, <a href="/docs/lang/fr/SERVER.html">FR</a> |</p>
|
||||
<div><p>| Aktualizováno 05.06.2023 | Jazyky: CZ, <a href="/docs/server.html">EN</a>, <a href="/docs/lang/fr/server.html">FR</a> |</p>
|
||||
<h1 id="hostovani-vlastniho-serveru-smp" tabindex="-1">Hostování vlastního serveru SMP</h1>
|
||||
<h2 id="prehled" tabindex="-1">Přehled</h2>
|
||||
<p>SMP server je relay server používaný k předávání zpráv v síti SimpleX. Aplikace SimpleX Chat mají přednastavené servery (pro mobilní aplikace jsou to smp11, smp12 a <a href="http://smp14.simplex.im">smp14.simplex.im</a>), ale konfiguraci aplikace můžete snadno změnit a používat jiné servery.</p>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Aktualizováno 07.02.2023 | Jazyky: CZ, <a href="/docs/SIMPLEX.html">EN</a>, <a href="/docs/lang/fr/SIMPLEX.html">FR</a> |</p>
|
||||
<div><p>| Aktualizováno 07.02.2023 | Jazyky: CZ, <a href="/docs/simplex.html">EN</a>, <a href="/docs/lang/fr/simplex.html">FR</a> |</p>
|
||||
<h1 id="platforma-simplex-motivace-a-srovnani" tabindex="-1">Platforma SimpleX - motivace a srovnání</h1>
|
||||
<h2 id="problemy" tabindex="-1">Problémy</h2>
|
||||
<p>Stávající chatovací platformy a protokoly mají některé nebo všechny následující problémy:</p>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Aktualizováno 31.01.2023 | Jazyky: CZ, <a href="/docs/SQL.html">EN</a>, <a href="/docs/lang/fr/SQL.html">FR</a> |</p>
|
||||
<div><p>| Aktualizováno 31.01.2023 | Jazyky: CZ, <a href="/docs/sql.html">EN</a>, <a href="/docs/lang/fr/sql.html">FR</a> |</p>
|
||||
<h1 id="pristup-ke-zpravam-v-databazi" tabindex="-1">Přístup ke zprávám v databázi</h1>
|
||||
<h2 id="desifrovani-databazi" tabindex="-1">Dešifrování databází</h2>
|
||||
<p>Chcete-li zobrazit data v databázi, musíte je nejprve dešifrovat. Nainstalujte <code>sqlcipher</code> pomocí svého oblíbeného správce balíčků a v adresáři s databázemi spusťte následující příkazy:</p>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Aktualizováno 07.02.2023 | Jazyky: CZ, <a href="/docs/TRANSLATIONS.html">EN</a> |</p>
|
||||
<div><p>| Aktualizováno 07.02.2023 | Jazyky: CZ, <a href="/docs/translations.html">EN</a> |</p>
|
||||
<h1 id="prispivani-prekladu-do-simplex-chat" tabindex="-1">Přispívání překladů do SimpleX Chat</h1>
|
||||
<p>Obrovské díky za váš zájem o překlady SimpleX Chat - velmi nám to pomáhá zpřístupnit jej širšímu okruhu uživatelů a vaší pomoci si opravdu vážíme.</p>
|
||||
<p>Vyžaduje to značnou časovou investici - většina lidí ji zpočátku podceňuje - a průběžnou údržbu v průběhu vývoje aplikace.</p>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Aktualizováno 31.01.2023 | Jazyky: CZ, <a href="/docs/WEBRTC.html">EN</a>, <a href="/docs/lang/fr/WEBRTC.html">FR</a> |</p>
|
||||
<div><p>| Aktualizováno 31.01.2023 | Jazyky: CZ, <a href="/docs/webrtc.html">EN</a>, <a href="/docs/lang/fr/webrtc.html">FR</a> |</p>
|
||||
<h1 id="pouziti-vlastnich-serveru-webrtc-ice-v-simplex-chat" tabindex="-1">Použití vlastních serverů WebRTC ICE v SimpleX Chat</h1>
|
||||
<h2 id="nasazeni-serveru-stunturn" tabindex="-1">Nasazení serveru STUN/TURN</h2>
|
||||
<p>V tomto průvodci budeme používat nejvybavenější a nejosvědčenější implementaci serveru STUN/TURN - <a href="https://github.com/coturn/coturn"><code>coturn</code></a> a <a href="https://ubuntu.com/download/server"><code>Ubuntu 20.04 LTS</code></a> distribuci Linuxu.</p>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| 07.02.2023 | FR, <a href="/docs/ANDROID.html">EN</a>, <a href="/docs/lang/cs/ANDROID.html">CZ</a> |</p>
|
||||
<div><p>| 07.02.2023 | FR, <a href="/docs/android.html">EN</a>, <a href="/docs/lang/cs/android.html">CZ</a> |</p>
|
||||
<h1 id="acces-aux-fichiers-dans-lapplication-android" tabindex="-1">Accès aux fichiers dans l'application Android</h1>
|
||||
<p>SimpleX utilise des bases de données et stocke ses préférences dans le répertoire de données privées d'Android. Ce répertoire contient</p>
|
||||
<ul>
|
||||
@@ -759,7 +759,7 @@ tar -xvzf chat.gz
|
||||
<p>Ensuite, la sauvegarde doit être terminée. Si vous voyez une erreur disant <code>tar : Error is not recoverable : exiting now</code> mais qu'avant cela vous avez enregistré quelques noms de fichiers, ne vous inquiétez pas, tout va bien.</p>
|
||||
<p>Maintenant les fichiers sauvegardés seront dans <code>./apps/chat.simplex.app/</code>.</p>
|
||||
<p>Veuillez noter que si vous utilisez une version récente de SimpleX, les bases de données seront chiffrées, et vous ne pourrez pas en voir le contenu sans utiliser l'application <code>sqlcipher</code> et sans connaître la phrase secrète de déchiffrement (vous devez d'abord la changer pour la vôtre à partir de celle qui est générée aléatoirement dans l'application).</p>
|
||||
<p>Veuillez suivre le guide <a href="/SQL.html">SQL.md</a> pour plus d'informations sur la manière de déchiffrer vos bases de données et d'y effectuer des requêtes.</p>
|
||||
<p>Veuillez suivre le guide <a href="/sql.html">SQL.md</a> pour plus d'informations sur la manière de déchiffrer vos bases de données et d'y effectuer des requêtes.</p>
|
||||
</div>
|
||||
</article>
|
||||
</main>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| 31.01.2023 | FR, <a href="/docs/CLI.html">EN</a>, <a href="/docs/lang/cs/CLI.html">CZ</a> |</p>
|
||||
<div><p>| 31.01.2023 | FR, <a href="/docs/cli.html">EN</a>, <a href="/docs/lang/cs/cli.html">CZ</a> |</p>
|
||||
<h1 id="application-de-terminal-console-simplex-chat-pour-linuxmacoswindows" tabindex="-1">Application de terminal (console) SimpleX Chat pour Linux/MacOS/Windows</h1>
|
||||
<h2 id="table-des-matieres" tabindex="-1">Table des matières</h2>
|
||||
<ul>
|
||||
@@ -893,7 +893,7 @@ brew services start tor
|
||||
<p>Ouvrir un terminal de commande SQLite :</p>
|
||||
<pre><code class="language-sh">sqlite3 ~/.simplex/simplex_v1_chat.db
|
||||
</code></pre>
|
||||
<p>Voir les <a href="SQL.html">requêtes de message</a> à titre d'exemple.</p>
|
||||
<p>Voir les <a href="sql.html">requêtes de message</a> à titre d'exemple.</p>
|
||||
<blockquote>
|
||||
<p><strong>Veuillez noter :</strong> Les contraintes de clé étrangère SQLite sont désactivées par défaut, et doivent être <strong><a href="https://sqlite.org/foreignkeys.html#fk_enable">activé séparément pour chaque connexion de base de données</a></strong>. Cette dernière peut être réalisée en exécutant la commande <code>PRAGMA foreign_keys = ON;</code> sur une connexion de base de données ouverte. En exécutant des requêtes modifiant les données sans activer les clés étrangères au préalable, vous risquez de mettre votre base de données dans un état inconsistant.</p>
|
||||
</blockquote>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| 31.01.2023 | FR, <a href="/docs/CONTRIBUTING.html">EN</a>, <a href="/docs/lang/cs/CONTRIBUTING.html">CZ</a> |</p>
|
||||
<div><p>| 31.01.2023 | FR, <a href="/docs/contributing.html">EN</a>, <a href="/docs/lang/cs/contributing.html">CZ</a> |</p>
|
||||
<h1 id="guide-pour-contribuer" tabindex="-1">Guide pour contribuer</h1>
|
||||
<h2 id="compiler-avec-le-chiffrement-sqlcipher-active" tabindex="-1">Compiler avec le chiffrement SQLCipher activé</h2>
|
||||
<p>Ajoutez <code>cabal.project.local</code> à la racine du projet avec les emplacements des en-têtes et des bibliothèques OpenSSL ainsi que le paramètre définissant le mode de chiffrement :</p>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| 05.06.2023 | FR, <a href="/docs/SERVER.html">EN</a>, <a href="/docs/lang/cs/SERVER.html">CZ</a> |</p>
|
||||
<div><p>| 05.06.2023 | FR, <a href="/docs/server.html">EN</a>, <a href="/docs/lang/cs/server.html">CZ</a> |</p>
|
||||
<h1 id="heberger-votre-propre-serveur-smp" tabindex="-1">Héberger votre propre serveur SMP</h1>
|
||||
<h2 id="presentation-generale" tabindex="-1">Présentation générale</h2>
|
||||
<p>Un serveur SMP est un serveur relais utilisé pour transmettre les messages sur le réseau SimpleX. Les apps SimpleX Chat ont des serveurs prédéfinis (pour les apps mobiles, smp11, smp12 et <a href="http://smp14.simplex.im">smp14.simplex.im</a>), mais vous pouvez facilement modifier la configuration de l'app pour utiliser d'autres serveurs.</p>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| 07.02.2023 | FR, <a href="/docs/SIMPLEX.html">EN</a>, <a href="/docs/lang/cs/SIMPLEX.html">CZ</a> |</p>
|
||||
<div><p>| 07.02.2023 | FR, <a href="/docs/simplex.html">EN</a>, <a href="/docs/lang/cs/simplex.html">CZ</a> |</p>
|
||||
<h1 id="plateforme-simplex-motivation-et-comparaison" tabindex="-1">Plateforme SimpleX - motivation et comparaison</h1>
|
||||
<h2 id="problemes" tabindex="-1">Problèmes</h2>
|
||||
<p>Les plateformes et protocoles de chat existants présentent une partie ou la totalité des problèmes suivants :</p>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| 31.01.2023 | FR, <a href="/docs/SQL.html">EN</a>, <a href="/docs/lang/cs/SQL.html">CZ</a> |</p>
|
||||
<div><p>| 31.01.2023 | FR, <a href="/docs/sql.html">EN</a>, <a href="/docs/lang/cs/sql.html">CZ</a> |</p>
|
||||
<h1 id="acces-aux-messages-de-la-base-de-donnees" tabindex="-1">Accès aux messages de la base de données</h1>
|
||||
<h2 id="dechiffrer-les-bases-de-donnees" tabindex="-1">Déchiffrer les bases de données</h2>
|
||||
<p>Afin de visualiser les données de la base de données, vous devez d'abord les déchiffrer. Installez <code>sqlcipher</code> en utilisant votre gestionnaire de paquets préféré et exécutez les commandes suivantes dans le répertoire contenant les bases de données :</p>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| 19.03.2023 | FR, <a href="/docs/TRANSLATIONS.html">EN</a>, <a href="/docs/lang/cs/TRANSLATIONS.html">CZ</a> |</p>
|
||||
<div><p>| 19.03.2023 | FR, <a href="/docs/translations.html">EN</a>, <a href="/docs/lang/cs/translations.html">CZ</a> |</p>
|
||||
<h1 id="contribuer-aux-traductions-de-simplex-chat" tabindex="-1">Contribuer aux traductions de SimpleX Chat</h1>
|
||||
<p>Un grand merci pour votre intérêt pour la traduction de SimpleX Chat - cela nous aide beaucoup à rendre l'application accessible à un plus grand nombre d'utilisateurs, et nous vous remercions de votre aide.</p>
|
||||
<p>Cela demande un investissement en temps considérable - la plupart des gens le sous-estiment au départ - et une maintenance continue au fur et à mesure que nous développons l'application.</p>
|
||||
|
||||
@@ -726,7 +726,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| 31.01.2023 | FR, <a href="/docs/WEBRTC.html">EN</a>, <a href="/docs/lang/cs/WEBRTC.html">CZ</a> |</p>
|
||||
<div><p>| 31.01.2023 | FR, <a href="/docs/webrtc.html">EN</a>, <a href="/docs/lang/cs/webrtc.html">CZ</a> |</p>
|
||||
<h1 id="utilisation-de-serveurs-webrtc-ice-personnalises-dans-simplex-chat" tabindex="-1">Utilisation de serveurs WebRTC ICE personnalisés dans SimpleX Chat</h1>
|
||||
<h2 id="deployer-un-serveur-stunturn" tabindex="-1">Déployer un serveur STUN/TURN</h2>
|
||||
<p>Pour ce guide, nous utiliserons l'implémentation de serveur STUN/TURN la plus complète et la plus testée - <a href="https://github.com/coturn/coturn"><code>coturn</code></a> et la distribution Linux <a href="https://ubuntu.com/download/server"><code>Ubuntu 20.04 LTS</code></a>.</p>
|
||||
|
||||
110
docs/server.html
110
docs/server.html
@@ -738,7 +738,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Updated 05.06.2023 | Languages: EN, <a href="/docs/lang/fr/SERVER.html">FR</a>, <a href="/docs/lang/cs/SERVER.html">CZ</a> |</p>
|
||||
<div><p>| Updated 05.06.2023 | Languages: EN, <a href="/docs/lang/fr/server.html">FR</a>, <a href="/docs/lang/cs/server.html">CZ</a> |</p>
|
||||
<h1 id="hosting-your-own-smp-server" tabindex="-1">Hosting your own SMP Server</h1>
|
||||
<h2 id="overview" tabindex="-1">Overview</h2>
|
||||
<p>SMP server is the relay server used to pass messages in SimpleX network. SimpleX Chat apps have preset servers (for mobile apps these are smp11, smp12 and <a href="http://smp14.simplex.im">smp14.simplex.im</a>), but you can easily change app configuration to use other servers.</p>
|
||||
@@ -750,16 +750,13 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
<p>First, install <code>smp-server</code>:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Manual deployment:</p>
|
||||
<ul>
|
||||
<li><a href="https://github.com/simplex-chat/simplexmq#using-your-distribution">Compiling from source</a></li>
|
||||
<li><a href="https://github.com/simplex-chat/simplexmq#install-binaries">Using pre-compiled binaries</a></li>
|
||||
</ul>
|
||||
<p>Manual deployment (see below)</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Alternatively, you can deploy <code>smp-server</code> using:</p>
|
||||
<p>Semi-automatic deployment:</p>
|
||||
<ul>
|
||||
<li><a href="https://github.com/simplex-chat/simplexmq#using-docker-1">Docker container</a></li>
|
||||
<li><a href="https://github.com/simplex-chat/simplexmq#using-installation-script">Offical installation script</a></li>
|
||||
<li><a href="https://github.com/simplex-chat/simplexmq#using-docker">Docker container</a></li>
|
||||
<li><a href="https://github.com/simplex-chat/simplexmq#deploy-smp-server-on-linode">Linode StackScript</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
@@ -767,7 +764,21 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</li>
|
||||
</ol>
|
||||
<p>Manual installation requires some preliminary actions:</p>
|
||||
<ol>
|
||||
<ol start="0">
|
||||
<li>
|
||||
<p>Install binary:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Using offical binaries:</p>
|
||||
<pre><code class="language-sh">curl -L https://github.com/simplex-chat/simplexmq/releases/latest/download/smp-server-ubuntu-20_04-x86-64 -o /usr/local/bin/smp-server
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Compiling from source:</p>
|
||||
<p>Please refer to <a href="https://github.com/simplex-chat/simplexmq#using-your-distribution">Build from source: Using your distribution</a></p>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
<p>Create user and group for <code>smp-server</code>:</p>
|
||||
<pre><code class="language-sh">sudo useradd -m smp
|
||||
@@ -791,24 +802,95 @@ sudo firewall-cmd --reload
|
||||
<li>
|
||||
<p><strong>Optional</strong> — If you're using distribution with <code>systemd</code>, create <code>/etc/systemd/system/smp-server.service</code> file with the following content:</p>
|
||||
<pre><code class="language-sh">[Unit]
|
||||
Description=SMP server
|
||||
Description=SMP server systemd service
|
||||
|
||||
[Service]
|
||||
User=smp
|
||||
Group=smp
|
||||
Type=simple
|
||||
ExecStart=smp-server start
|
||||
ExecStart=/usr/local/bin/smp-server start +RTS -N -RTS
|
||||
ExecStopPost=/usr/bin/env sh -c '[ -e "/var/opt/simplex/smp-server-store.log" ] && cp "/var/opt/simplex/smp-server-store.log" "/var/opt/simplex/smp-server-store.log.bak"'
|
||||
LimitNOFILE=65535
|
||||
KillSignal=SIGINT
|
||||
TimeoutStopSec=infinity
|
||||
Restart=always
|
||||
RestartSec=10
|
||||
LimitNOFILE=65535
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
</code></pre>
|
||||
<p>And execute <code>sudo systemctl daemon-reload</code>.</p>
|
||||
</li>
|
||||
</ol>
|
||||
<h2 id="tor-installation" tabindex="-1">Tor installation</h2>
|
||||
<p>smp-server can also be deployed to serve from <a href="https://www.torproject.org">tor</a> network. Run the following commands as <code>root</code> user.</p>
|
||||
<ol>
|
||||
<li>
|
||||
<p>Install tor:</p>
|
||||
<p>We're assuming you're using Ubuntu/Debian based distributions. If not, please refer to <a href="https://community.torproject.org/onion-services/setup/install/">offical tor documentation</a> or your distribution guide.</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Configure offical Tor PPA repository:</p>
|
||||
<pre><code class="language-sh">CODENAME="$(lsb_release -c | awk '{print $2}')"
|
||||
echo "deb [signed-by=/usr/share/keyrings/tor-archive-keyring.gpg] https://deb.torproject.org/torproject.org ${CODENAME} main
|
||||
deb-src [signed-by=/usr/share/keyrings/tor-archive-keyring.gpg] https://deb.torproject.org/torproject.org ${CODENAME} main" > /etc/apt/sources.list.d/tor.list
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Import repository key:</p>
|
||||
<pre><code class="language-sh">curl --proto '=https' --tlsv1.2 -sSf https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --dearmor | tee /usr/share/keyrings/tor-archive-keyring.gpg >/dev/null
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Update repository index:</p>
|
||||
<pre><code class="language-sh">apt update
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Install <code>tor</code> package:</p>
|
||||
<pre><code class="language-sh">apt install -y tor deb.torproject.org-keyring
|
||||
</code></pre>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
<p>Configure tor:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>File configuration:</p>
|
||||
<p>Open tor configuration with your editor of choice (<code>nano</code>,<code>vim</code>,<code>emacs</code>,etc.):</p>
|
||||
<pre><code class="language-sh">vim /etc/tor/torrc
|
||||
</code></pre>
|
||||
<p>And insert the following lines to the bottom of configuration. Please note lines starting with <code>#</code>: this is comments about each individual options.</p>
|
||||
<pre><code class="language-sh"># Enable log (otherwise, tor doesn't seemd to deploy onion address)
|
||||
Log notice file /var/log/tor/notices.log
|
||||
# Enable single hop routing (2 options below are dependencies of third). Will reduce latency in exchange of anonimity (since tor runs alongside smp-server and onion address will be displayed in clients, this is totally fine)
|
||||
SOCKSPort 0
|
||||
HiddenServiceNonAnonymousMode 1
|
||||
HiddenServiceSingleHopMode 1
|
||||
# smp-server hidden service host directory and port mappings
|
||||
HiddenServiceDir /var/lib/tor/simplex-smp/
|
||||
HiddenServicePort 5223 localhost:5223
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Create directories:</p>
|
||||
<pre><code class="language-sh">mkdir /var/lib/tor/simplex-smp/ && chown debian-tor:debian-tor /var/lib/tor/simplex-smp/ && chmod 700 /var/lib/tor/simplex-smp/
|
||||
</code></pre>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
<p>Start tor:</p>
|
||||
<p>Enable <code>systemd</code> service and start tor. Offical <code>tor</code> is a bit flunky on the first start and may not create onion host address, so we're restarting it just in case.</p>
|
||||
<pre><code class="language-sh">systemctl enable tor && systemctl start tor && systemctl restart tor
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Display onion host:</p>
|
||||
<p>Execute the following command to display your onion host address:</p>
|
||||
<pre><code class="language-sh">cat /var/lib/tor/simplex-smp/hostname
|
||||
</code></pre>
|
||||
</li>
|
||||
</ol>
|
||||
<h2 id="configuration" tabindex="-1">Configuration</h2>
|
||||
<p>To see which options are available, execute <code>smp-server</code> without flags:</p>
|
||||
<pre><code class="language-sh">sudo su smp -c smp-server
|
||||
|
||||
@@ -738,7 +738,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Updated 07.02.2023 | Languages: EN, <a href="/docs/lang/fr/SIMPLEX.html">FR</a>, <a href="/docs/lang/cs/SIMPLEX.html">CZ</a> |</p>
|
||||
<div><p>| Updated 07.02.2023 | Languages: EN, <a href="/docs/lang/fr/simplex.html">FR</a>, <a href="/docs/lang/cs/simplex.html">CZ</a> |</p>
|
||||
<h1 id="simplex-platform-motivation-and-comparison" tabindex="-1">SimpleX platform - motivation and comparison</h1>
|
||||
<h2 id="problems" tabindex="-1">Problems</h2>
|
||||
<p>Existing chat platforms and protocols have some or all of the following problems:</p>
|
||||
|
||||
@@ -738,7 +738,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Updated 31.01.2023 | Languages: EN, <a href="/docs/lang/fr/SQL.html">FR</a>, <a href="/docs/lang/cs/SQL.html">CZ</a> |</p>
|
||||
<div><p>| Updated 31.01.2023 | Languages: EN, <a href="/docs/lang/fr/sql.html">FR</a>, <a href="/docs/lang/cs/sql.html">CZ</a> |</p>
|
||||
<h1 id="accessing-messages-in-the-database" tabindex="-1">Accessing messages in the database</h1>
|
||||
<h2 id="decrypting-databases" tabindex="-1">Decrypting databases</h2>
|
||||
<p>In order to view database data you need to decrypt it first. Install <code>sqlcipher</code> using your favorite package manager and run the following commands in the directory with databases:</p>
|
||||
|
||||
@@ -738,7 +738,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| 19.03.2023 | EN, <a href="/docs/lang/cs/TRANSLATIONS.html">CZ</a>, <a href="/docs/lang/fr/TRANSLATIONS.html">FR</a> |</p>
|
||||
<div><p>| 19.03.2023 | EN, <a href="/docs/lang/cs/translations.html">CZ</a>, <a href="/docs/lang/fr/translations.html">FR</a> |</p>
|
||||
<h1 id="contributing-translations-to-simplex-chat" tabindex="-1">Contributing translations to SimpleX Chat</h1>
|
||||
<p>Huge thanks for your interest in translating SimpleX Chat - it helps a lot to make it accessible to a wider range of users, and we really appreciate your help.</p>
|
||||
<p>It requires a substantial time investment - most people underestimate it initially - and ongoing maintenance as we develop the application.</p>
|
||||
|
||||
@@ -738,7 +738,7 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div><p>| Updated 31.01.2023 | Languages: EN, <a href="/docs/lang/fr/WEBRTC.html">FR</a>, <a href="/docs/lang/cs/WEBRTC.html">CZ</a> |</p>
|
||||
<div><p>| Updated 31.01.2023 | Languages: EN, <a href="/docs/lang/fr/webrtc.html">FR</a>, <a href="/docs/lang/cs/webrtc.html">CZ</a> |</p>
|
||||
<h1 id="using-custom-webrtc-ice-servers-in-simplex-chat" tabindex="-1">Using custom WebRTC ICE servers in SimpleX Chat</h1>
|
||||
<h2 id="deploy-stunturn-server" tabindex="-1">Deploy STUN/TURN server</h2>
|
||||
<p>For this guide, we'll be using the most featureful and battle-tested STUN/TURN server implementation – <a href="https://github.com/coturn/coturn"><code>coturn</code></a> and <a href="https://ubuntu.com/download/server"><code>Ubuntu 20.04 LTS</code></a> Linux distribution.</p>
|
||||
|
||||
@@ -672,13 +672,40 @@ window.addEventListener('scroll',changeHeaderBg);
|
||||
<li>protection of sender IP address from the recipients.</li>
|
||||
</ul>
|
||||
<h2 id="installation" tabindex="-1">Installation</h2>
|
||||
<ol>
|
||||
<ol start="0">
|
||||
<li>
|
||||
<p>Download <code>xftp-server</code> binary:</p>
|
||||
<pre><code class="language-sh">sudo curl -L https://github.com/simplex-chat/simplexmq/releases/latest/download/xftp-server-ubuntu-20_04-x86-64 -o /usr/local/bin/xftp-server && sudo chmod +x /usr/local/bin/xftp-server
|
||||
<p>First, install <code>xftp-server</code>:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Manual deployment (see below)</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Semi-automatic deployment:</p>
|
||||
<ul>
|
||||
<li><a href="https://github.com/simplex-chat/simplexmq#using-installation-script">Offical installation script</a></li>
|
||||
<li><a href="https://github.com/simplex-chat/simplexmq#using-docker">Docker container</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ol>
|
||||
<p>Manual installation requires some preliminary actions:</p>
|
||||
<ol start="0">
|
||||
<li>
|
||||
<p>Install binary:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Using offical binaries:</p>
|
||||
<pre><code class="language-sh">curl -L https://github.com/simplex-chat/simplexmq/releases/latest/download/xftp-server-ubuntu-20_04-x86-64 -o /usr/local/bin/xftp-server
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Compiling from source:</p>
|
||||
<p>Please refer to <a href="https://github.com/simplex-chat/simplexmq#using-your-distribution">Build from source: Using your distribution</a></p>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
<p>Create user and group for <code>xftp-server</code>:</p>
|
||||
<pre><code class="language-sh">sudo useradd -m xftp
|
||||
</code></pre>
|
||||
@@ -720,6 +747,77 @@ WantedBy=multi-user.target
|
||||
<p>And execute <code>sudo systemctl daemon-reload</code>.</p>
|
||||
</li>
|
||||
</ol>
|
||||
<h2 id="tor-installation" tabindex="-1">Tor installation</h2>
|
||||
<p>xftp-server can also be deployed to serve from <a href="https://www.torproject.org">tor</a> network. Run the following commands as <code>root</code> user.</p>
|
||||
<ol>
|
||||
<li>
|
||||
<p>Install tor:</p>
|
||||
<p>We're assuming you're using Ubuntu/Debian based distributions. If not, please refer to <a href="https://community.torproject.org/onion-services/setup/install/">offical tor documentation</a> or your distribution guide.</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Configure offical Tor PPA repository:</p>
|
||||
<pre><code class="language-sh">CODENAME="$(lsb_release -c | awk '{print $2}')"
|
||||
echo "deb [signed-by=/usr/share/keyrings/tor-archive-keyring.gpg] https://deb.torproject.org/torproject.org ${CODENAME} main
|
||||
deb-src [signed-by=/usr/share/keyrings/tor-archive-keyring.gpg] https://deb.torproject.org/torproject.org ${CODENAME} main" > /etc/apt/sources.list.d/tor.list
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Import repository key:</p>
|
||||
<pre><code class="language-sh">curl --proto '=https' --tlsv1.2 -sSf https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --dearmor | tee /usr/share/keyrings/tor-archive-keyring.gpg >/dev/null
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Update repository index:</p>
|
||||
<pre><code class="language-sh">apt update
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Install <code>tor</code> package:</p>
|
||||
<pre><code class="language-sh">apt install -y tor deb.torproject.org-keyring
|
||||
</code></pre>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
<p>Configure tor:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>File configuration:</p>
|
||||
<p>Open tor configuration with your editor of choice (<code>nano</code>,<code>vim</code>,<code>emacs</code>,etc.):</p>
|
||||
<pre><code class="language-sh">vim /etc/tor/torrc
|
||||
</code></pre>
|
||||
<p>And insert the following lines to the bottom of configuration. Please note lines starting with <code>#</code>: this is comments about each individual options.</p>
|
||||
<pre><code class="language-sh"># Enable log (otherwise, tor doesn't seemd to deploy onion address)
|
||||
Log notice file /var/log/tor/notices.log
|
||||
# Enable single hop routing (2 options below are dependencies of third). Will reduce latency in exchange of anonimity (since tor runs alongside xftp-server and onion address will be displayed in clients, this is totally fine)
|
||||
SOCKSPort 0
|
||||
HiddenServiceNonAnonymousMode 1
|
||||
HiddenServiceSingleHopMode 1
|
||||
# xftp-server hidden service host directory and port mappings
|
||||
HiddenServiceDir /var/lib/tor/simplex-xftp/
|
||||
HiddenServicePort 443 localhost:443
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Create directories:</p>
|
||||
<pre><code class="language-sh">mkdir /var/lib/tor/simplex-xftp/ && chown debian-tor:debian-tor /var/lib/tor/simplex-xftp/ && chmod 700 /var/lib/tor/simplex-xftp/
|
||||
</code></pre>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>
|
||||
<p>Start tor:</p>
|
||||
<p>Enable <code>systemd</code> service and start tor. Offical <code>tor</code> is a bit flunky on the first start and may not create onion host address, so we're restarting it just in case.</p>
|
||||
<pre><code class="language-sh">systemctl enable tor && systemctl start tor && systemctl restart tor
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
<p>Display onion host:</p>
|
||||
<p>Execute the following command to display your onion host address:</p>
|
||||
<pre><code class="language-sh">cat /var/lib/tor/simplex-xftp/hostname
|
||||
</code></pre>
|
||||
</li>
|
||||
</ol>
|
||||
<h2 id="configuration" tabindex="-1">Configuration</h2>
|
||||
<p>To see which options are available, execute <code>xftp-server</code> without flags:</p>
|
||||
<pre><code class="language-sh">sudo su xftp -c xftp-server
|
||||
@@ -942,7 +1040,7 @@ allow_local_mode = true
|
||||
</ol>
|
||||
<p>For further documentation, see: <a href="https://grafana.github.io/grafana-csv-datasource/">CSV Data Source for Grafana - Documentation</a></p>
|
||||
<h3 id="configuring-the-app-to-use-the-server" tabindex="-1">Configuring the app to use the server</h3>
|
||||
<p>Please see: <a href="SERVER.html#configuring-the-app-to-use-the-server">SMP Server: Configuring the app to use the server</a>.</p>
|
||||
<p>Please see: <a href="server.html#configuring-the-app-to-use-the-server">SMP Server: Configuring the app to use the server</a>.</p>
|
||||
</div>
|
||||
</article>
|
||||
</main>
|
||||
|
||||
@@ -1523,7 +1523,7 @@ file ---&gt; | XFTP | ------&gt; XFTP ----&
|
||||
<h2 id="customize-and-share-color-themes" tabindex="-1">Customize and share color themes</h2>
|
||||
<img src="https://simplex.chat/blog/images/20230523-theme.png" width="288" />
|
||||
<p>Android app now allows choosing between three color themes - Light, Dark and SimpleX (a dark blue theme). You can customize any theme by setting 9 different colors used in the app, including titles, menus, accent colors and colors for sent and received messages.</p>
|
||||
<p>You can share your theme with other users by exporting it to a file and sending to them. You can also <a href="https://simplex.chat/blog/docs/THEMES.html">contribute your favorite themes</a> to our GitHub repository.</p>
|
||||
<p>You can share your theme with other users by exporting it to a file and sending to them. You can also <a href="https://simplex.chat/blog/docs/themes.html">contribute your favorite themes</a> to our GitHub repository.</p>
|
||||
<h2 id="self-destruct-passcode" tabindex="-1">Self-destruct passcode</h2>
|
||||
<img src="https://simplex.chat/blog/images/20230523-self-destruct.png" width="288" />
|
||||
<p>This is something many of you asked before - when asked to enter the app passcode under duress, to be able to enter a special self-destruct code that would remove the app data. This feature is offered in many security tools, and now you can configure it in SimpleX Chat as well.</p>
|
||||
@@ -1623,8 +1623,8 @@ file ---&gt; | XFTP | ------&gt; XFTP ----&
|
||||
<p>Please report the cases when messages are not delivered – delivery receipts should help with that.</p>
|
||||
<h4 id="messages-failed-to-decrypt-problem-solved" tabindex="-1">Messages failed to decrypt? Problem solved!</h4>
|
||||
<p>Previously, a growing number of users had the issue when after restoring the chat database from backup, messages from some contacts failed to decrypt and were showing an error in the app.</p>
|
||||
<p>This happens due to double ratchet protocol protecting the integrity of end-to-end encryption after the compromise - <a href="https://simplex.chat/blog/docs/GLOSSARY.html#post-compromise-security">post-compromise security</a>. The protocol logic does not allow to use the old version of the database to decrypt the message.</p>
|
||||
<p>v5.2 added the extension to the messaging protocol allowing to negotiate the new ratchet keys in such cases - both with the contacts and the group members. This requires a user action, and it resets the security code verification status for this contact or member – you need to verify it again to have the additional protection from <a href="https://simplex.chat/blog/docs/GLOSSARY.html#man-in-the-middle-attack">man-in-the-middle attacks</a>.</p>
|
||||
<p>This happens due to double ratchet protocol protecting the integrity of end-to-end encryption after the compromise - <a href="https://simplex.chat/blog/docs/glossary.html#post-compromise-security">post-compromise security</a>. The protocol logic does not allow to use the old version of the database to decrypt the message.</p>
|
||||
<p>v5.2 added the extension to the messaging protocol allowing to negotiate the new ratchet keys in such cases - both with the contacts and the group members. This requires a user action, and it resets the security code verification status for this contact or member – you need to verify it again to have the additional protection from <a href="https://simplex.chat/blog/docs/glossary.html#man-in-the-middle-attack">man-in-the-middle attacks</a>.</p>
|
||||
<p>The negotiation of the new ratchet keys still happens via the end-to-end encrypted messages, as the protocol has two layers of end-to-end encryption, so it cannot be compromised by the messaging relays.</p>
|
||||
<p>You may still lose connection if you or your contact changed the receiving address after you made the backup, so make sure to make a new backup after any receiving address changes.</p>
|
||||
<h4 id="reconnect-the-servers" tabindex="-1">Reconnect the servers</h4>
|
||||
|
||||
6
feed.rss
6
feed.rss
@@ -72,8 +72,8 @@
|
||||
<p>Please report the cases when messages are not delivered – delivery receipts should help with that.</p>
|
||||
<h4 id="messages-failed-to-decrypt-problem-solved" tabindex="-1">Messages failed to decrypt? Problem solved!</h4>
|
||||
<p>Previously, a growing number of users had the issue when after restoring the chat database from backup, messages from some contacts failed to decrypt and were showing an error in the app.</p>
|
||||
<p>This happens due to double ratchet protocol protecting the integrity of end-to-end encryption after the compromise - <a href="https://simplex.chat/blog/docs/GLOSSARY.html#post-compromise-security">post-compromise security</a>. The protocol logic does not allow to use the old version of the database to decrypt the message.</p>
|
||||
<p>v5.2 added the extension to the messaging protocol allowing to negotiate the new ratchet keys in such cases - both with the contacts and the group members. This requires a user action, and it resets the security code verification status for this contact or member – you need to verify it again to have the additional protection from <a href="https://simplex.chat/blog/docs/GLOSSARY.html#man-in-the-middle-attack">man-in-the-middle attacks</a>.</p>
|
||||
<p>This happens due to double ratchet protocol protecting the integrity of end-to-end encryption after the compromise - <a href="https://simplex.chat/blog/docs/glossary.html#post-compromise-security">post-compromise security</a>. The protocol logic does not allow to use the old version of the database to decrypt the message.</p>
|
||||
<p>v5.2 added the extension to the messaging protocol allowing to negotiate the new ratchet keys in such cases - both with the contacts and the group members. This requires a user action, and it resets the security code verification status for this contact or member – you need to verify it again to have the additional protection from <a href="https://simplex.chat/blog/docs/glossary.html#man-in-the-middle-attack">man-in-the-middle attacks</a>.</p>
|
||||
<p>The negotiation of the new ratchet keys still happens via the end-to-end encrypted messages, as the protocol has two layers of end-to-end encryption, so it cannot be compromised by the messaging relays.</p>
|
||||
<p>You may still lose connection if you or your contact changed the receiving address after you made the backup, so make sure to make a new backup after any receiving address changes.</p>
|
||||
<h4 id="reconnect-the-servers" tabindex="-1">Reconnect the servers</h4>
|
||||
@@ -181,7 +181,7 @@
|
||||
<h2 id="customize-and-share-color-themes" tabindex="-1">Customize and share color themes</h2>
|
||||
<img src="https://simplex.chat/blog/images/20230523-theme.png" width="288" />
|
||||
<p>Android app now allows choosing between three color themes - Light, Dark and SimpleX (a dark blue theme). You can customize any theme by setting 9 different colors used in the app, including titles, menus, accent colors and colors for sent and received messages.</p>
|
||||
<p>You can share your theme with other users by exporting it to a file and sending to them. You can also <a href="https://simplex.chat/blog/docs/THEMES.html">contribute your favorite themes</a> to our GitHub repository.</p>
|
||||
<p>You can share your theme with other users by exporting it to a file and sending to them. You can also <a href="https://simplex.chat/blog/docs/themes.html">contribute your favorite themes</a> to our GitHub repository.</p>
|
||||
<h2 id="self-destruct-passcode" tabindex="-1">Self-destruct passcode</h2>
|
||||
<img src="https://simplex.chat/blog/images/20230523-self-destruct.png" width="288" />
|
||||
<p>This is something many of you asked before - when asked to enter the app passcode under duress, to be able to enter a special self-destruct code that would remove the app data. This feature is offered in many security tools, and now you can configure it in SimpleX Chat as well.</p>
|
||||
|
||||
Reference in New Issue
Block a user