SimpleX Chat User Guide

The first messaging platform that has no user identifiers of any kind — 100% private by design.


Quick start

Create your first chat profile

After downloading SimpleX Chat via the links at

  • Open the app.
  • Create a new profile by inputting your display name and full name (optional).
  • Tap on "Create".

This profile is local to the device, it is not stored anywhere else

Choose notifications mode

After you have created the chat profile the app will ask you to choose notifications mode.

Please read their description, as on iOS it is trade-off between convenience and privacy, with instant notifications sharing more meta-data with the servers, and on Android it is a trade-off between notification delays and battery life.

You can read more about the differences between notifications work on Android and iOS.

Connect to developers

When you just start using the app, you can tap "chat with the developers" to ask any questions or just to test the app - feel free to send any test messages.

This button will disappear once you make the first connection. To connect to the developers later:

Join some user groups

There are links to join several user groups on our GitHub page - join them to ask any questions and discuss ideas.

You can also find some other user-managed groups via online search.

To join a group via a link:

  • Get a link to a SimpleX user group, which you can get from your existing SimpleX conversations or by finding it online.
  • Tap on a button in the lower right-hand of the screen.
  • Tap on "Connect via link / QR code" button.

Connect to friends

  • Tell your friends to download SimpleX Chat app via one of the links here:
  • Create a one-time link for each of you friends by tapping new chat button (Android: a floating pencil button in the bottom right corner, iOS: a pencil button in the top right corner)
  • Tap Create one-time invitation link.
  • Share each link with a different friend, or alternatively let them scan a QR code.
  • You can optionally assign a different alias to each link, to know when they connect who is who, if they use incognito mode, for example.
  • To use your link or QR code, tell your friends to tap new chat button and then tap on "Connect via link / QR code".
  • They can either scan QR code or paste the link. If they opened the link in the browser, they need to tap "Open in mobile app" button on the page.

Watch the video on the website that shows how it works.

You can also create a long-term contact address.

Explore the app

Most app settings are shared for all profiles, but some settings are specific to chat profile.

Read more in App settings page.

Many conversation actions are available via long-press or swipe – try them!

© 2020-2024 SimpleX | Open-Source Project