.. _librem_one_first:

First Steps
===========

Account management
------------------

Visit your `profile page <https://librem.one/accounts/profile/>`__ if you want to:

  * activate *Librem Tunnel*
  * invite more people to your family account
  * change your password
  * change your recovery email address
  * change your billing email address
  * delete your account

Librem Tunnel activation
^^^^^^^^^^^^^^^^^^^^^^^^

Open your account profile and click the **Activate** button:

.. image:: img/addams0.png
   :scale: 60%
   :alt: Tunnel activation


Family account — invite members
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you registered a family account, it is simple to invite more people. Go to your account profile and scroll down. Click the **New Invitation** button:

.. image:: img/addams1.png
   :scale: 90%
   :alt: Invite 1

You will then see the invitation link under *Group Invite*:

.. image:: img/addams2.png
   :scale: 90%
   :alt: Invite 1

It expires after 24 hours, after which you need to create new invite link. If you have all 5 account slots taken (you invited 5 people and they all registered), you cannot create more invite links.
When someone registers using your invite link, you will have them listed under *Group members*:

.. image:: img/addams3.png
   :scale: 90%
   :alt: Invite 1


Get the bundle
--------------

Mobile
^^^^^^

Download and install applications:

  * Librem One app hub: `Android only <https://play.google.com/store/apps/details?id=one.librem.one>`__, *iOS coming soon*
  * Librem Chat: `Android <https://play.google.com/store/apps/details?id=one.librem.chat>`__, `iOS <https://itunes.apple.com/us/app/librem-chat/id1456162175?mt=8>`__
  * Librem Social: `Android <https://play.google.com/store/apps/details?id=one.librem.social>`__, `iOS <https://itunes.apple.com/us/app/librem-social/id1456164071?mt=8>`__
  * Librem Mail: `Android only <https://play.google.com/store/apps/details?id=one.librem.mail>`__, install `OpenKeychain <https://play.google.com/store/apps/details?id=org.sufficientlysecure.keychain>`__ too
  * Librem Tunnel: `Android <https://play.google.com/store/apps/details?id=one.librem.tunnel>`__, `iOS <https://itunes.apple.com/us/app/librem-tunnel/id1456167723?mt=8>`__

Sign in to each app with your Librem One credentials.

Desktop
^^^^^^^

  * Librem Chat: Download and install `Riot <https://riot.im/download/desktop/>`__ (`login instructions <https://docs.puri.sm/Librem_One/Generic.html#librem-chat>`__)
  * Librem Social: Open `<https://social.librem.one>`__ in your browser, login with your Librem One credentials
  * Librem Mail: `Thunderbird <https://www.thunderbird.net/download/>`__ with `Enigmail <https://enigmail.net/index.php/en/download>`__ (`setup instructions <https://docs.puri.sm/Librem_One/PureOS/Email.html>`__)
  * Librem Tunnel: `GNU/Linux based systems setup <https://docs.puri.sm/Librem_One/PureOS/VPN_Tunnel.html>`__, *others coming soon*

Quick start
-----------

Here's an overview of the everyday tasks you can perform with Librem One services. We provide additional links if you need more detailed instructions.

Librem Chat
^^^^^^^^^^^

Call or text someone you know
+++++++++++++++++++++++++++++

  * Launch the Librem Chat app
  * Click the **Add** button next to **People**
  * Search for the user, for example `@example:librem.one`
  * Invite them to chat
  * Enable encryption in your one-on-one chatroom
  * Start typing, or hit the **Call** button

You can also search for users outside the Librem One domain.

Join a community chatroom
+++++++++++++++++++++++++

  * Launch the Librem Chat app
  * Click the **Add** button next to **Rooms**
  * In the search box, enter a whole or partial room name, like `#support:librem.one`
  * In the search results, check the room topic to review community rules and what's on-topic
  * Click on the room to join
  * Ask questions and help others!

You can also join rooms outside the Librem One domain. Remember, if a room isn't private anyone can read conversations; messages are deleted after 30 days.

For more detailed instructions, see our Librem Chat guides for `Android <https://docs.puri.sm/Librem_One/Android/Chat.html>`__, `iOS <https://docs.puri.sm/Librem_One/iOS/Chat.html>`__, `PureOS <https://docs.puri.sm/Librem_One/PureOS/Chat.html>`__ and `other platforms <https://docs.puri.sm/Librem_One/Generic.html#librem-chat>`__.

Librem Social
^^^^^^^^^^^^^

See what everyone is posting
++++++++++++++++++++++++++++

  * Launch the Librem Social app
  * In the search bar, enter a topic you care about, like `#art` or `#science`
  * Select a hashtag from the results
  * Now you can see all posts on that topic

You only see posts on topics you search for. Results will include posts from outside the Librem One domain.

Follow someone you know
+++++++++++++++++++++++

  * Launch the Librem Social app
  * Search for someone using their full address, like `purism@librem.one` or `privacyint@mastodon.xyz`
  * Click the **Follow** icon

You may have to wait for approval before your friend's posts appear in your social inbox.

Share your thoughts with the world
++++++++++++++++++++++++++++++++++

  * Launch the Librem Social app
  * Capture your thoughts in 500 characters or less
  * Use hashtags to make your post discoverable
  * Click "Post!"

Remember, your posts are shared under `CC BY-SA 4.0 <https://creativecommons.org/licenses/by-sa/4.0/>`_ so that anyone can share and remix them.

For more detailed instructions, see our Librem Social guides for `Android <https://docs.puri.sm/Librem_One/Android/Social.html>`__, `iOS <https://docs.puri.sm/Librem_One/iOS/Social.html>`__, `PureOS <https://docs.puri.sm/Librem_One/PureOS/Social.html>`__ and `other platforms <https://docs.puri.sm/Librem_One/Generic.html#librem-social>`__.

Librem Mail
^^^^^^^^^^^

Send encrypted mail
+++++++++++++++++++

  * Generate an encryption key
  * Add the key of the person you know to your keychain
  * Launch the Librem Mail app
  * Write a message
  * Encrypt it with their key
  * Hit send!

For more detailed instructions, see our Librem Mail guides for `Android <https://docs.puri.sm/Librem_One/Android/Email.html>`__, `iOS <https://docs.puri.sm/Librem_One/iOS/Email.html>`__, `PureOS <https://docs.puri.sm/Librem_One/PureOS/Email.html>`__ and `other platforms <https://docs.puri.sm/Librem_One/Generic.html#librem-mail>`__.

Librem Tunnel
^^^^^^^^^^^^^

Secure your connection
++++++++++++++++++++++

  * In your browser, open your Librem One profile
  * Activate your tunnel connection (if it isn't already active)
  * Launch the Librem Tunnel app
  * (Android) Click on the rocket icon to install your Librem Tunnel profile
  * (PureOS) From the command line run `liberty tunnel-setup`
  * Enter your Librem One credentials
  * Enable the connection

For more detailed instructions, see our Librem Tunnel guides for `Android <https://docs.puri.sm/Librem_One/Android/VPN_Tunnel.html>`__, `iOS <https://docs.puri.sm/Librem_One/iOS/VPN_Tunnel.html>`__, `PureOS <https://docs.puri.sm/Librem_One/PureOS/VPN_Tunnel.html>`__ and `other platforms <https://docs.puri.sm/Librem_One/Generic.html#librem-tunnel>`__.