.. include:: /urls.rst

.. _pureos_configuration_initial_setup:

Initial Setup
=============


.. _pureos_configuration_initial_setup_normal:

Normal procedure
^^^^^^^^^^^^^^^^

When you first boot into PureOS live instance or :ref:`OEM Installation <pureos_configuration_initial_setup_oem>` pre-setup screen, you will be greeted with **PureOS Initial Setup** procedure:

#. First select your language and click **Next**.
   You can click the menu button (⁝) to search for your language:

   .. image:: ../img/gnome-initial-setup/welcome.png
      :scale: 50%
      :alt: Welcome screen
      :class: no-scaled-link

#. Select keyboard layout:

   .. seealso::
      :ref:`Keyboard Layout <pureos_configuration_keyboard>`

   .. image:: ../img/gnome-initial-setup/typing.png
      :scale: 50%
      :alt: Keyboard layouts
      :class: no-scaled-link

#. Again, you can click the menu button (⁝) and look for a keyboard layout of your choice, then click **Next**:

   .. image:: ../img/gnome-initial-setup/keyboard-layout-selection.png
      :scale: 50%
      :alt: Keyboard layout selection
      :class: no-scaled-link

#. Optional: Connect to a wifi network, then click **Next**.
   Skip this step by clicking **Skip** without selecting a wireless network:

   .. image:: ../img/gnome-initial-setup/wireless-networks.png
      :scale: 50%
      :alt: Wireless network selection
      :class: no-scaled-link

#. Optional: Enable location services, then click **Next**.
   Skip this step by clicking **Next** without enabling the toggle switch:

   .. image:: ../img/gnome-initial-setup/privacy.png
      :scale: 50%
      :alt: Location services
      :class: no-scaled-link

#. You completed the initial setup! Click **Start Using PureOS** to exit the window.

   .. image:: ../img/gnome-initial-setup/setup-finished.png
      :scale: 50%
      :alt: Initial setup complete
      :class: no-scaled-link


.. _pureos_configuration_initial_setup_oem:

OEM setup
^^^^^^^^^

`PureOS OEM ISO image (GNOME)`_ files are ones Purism uses during the PureOS OEM install procedure.

.. note::
   This guide assumes first start after OEM prepared installation.

#. The first screen will let you configure language.
   Press the menu button (⁝) to search for other languages and press **Next** once ready to proceed:

   .. image:: ../img/gnome-initial-setup/welcome.png
      :scale: 50%
      :alt: Welcome screen
      :class: no-scaled-link

#. Select the keyboard layout.
   Press the menu button (⁝) to search for more layouts, then click **Next** to continue:

   .. seealso::
      :ref:`Keyboard Layout <pureos_configuration_keyboard>`

   .. image:: ../img/gnome-initial-setup/typing.png
      :scale: 50%
      :alt: Keyboard layout selection
      :class: no-scaled-link

#. Optional: Connect to a wifi network, then click **Next**.
   Skip this step by clicking **Skip** without selecting a wireless network:

   .. image:: ../img/gnome-initial-setup/wireless-networks.png
      :scale: 50%
      :alt: Wireless network selection
      :class: no-scaled-link

#. Optional: Enable location services, then click **Next**.
   Skip this step by clicking **Next** without enabling the toggle switch:

   .. image:: ../img/gnome-initial-setup/privacy.png
      :scale: 50%
      :alt: Location services
      :class: no-scaled-link

#. Select your timezone and click **Next** to continue:

   .. image:: ../img/gnome-initial-setup/timezone-selection.png
      :scale: 50%
      :alt: Timezone selection
      :class: no-scaled-link

#. Assign a name to your device and click **Next** to continue:

   .. image:: ../img/gnome-initial-setup/device-name.png
      :scale: 50%
      :alt: Hostname entry
      :class: no-scaled-link

#. Set up your disk encryption password and click **Next** to continue:

   .. warning::
      Choose your password so that you can reproduce it only with us-international keyboard layout!
      You won't be able to type non-latin alphabet in the password prompt when you start your laptop.

   .. image:: ../img/gnome-initial-setup/fde-passphrase-creation.png
      :scale: 50%
      :alt: Full-disk-encryption password creation
      :class: no-scaled-link

   .. warning::
      If you forget this password, you won't be able to boot and access your data!
      You will have to re-install PureOS either using our `PureOS OEM ISO image`_ or using a `PureOS Live ISO image`_ with :ref:`Calamares installer <pureos_installation_live>` in order to have a usable system!

#. Enter your full name and a username for your account:

   .. warning::
      Your username must be all lowercase, or else the setup will fail!

   .. image:: ../img/gnome-initial-setup/about-you.png
      :scale: 50%
      :alt: About You
      :class: no-scaled-link

#. Set up your account password:

   .. image:: ../img/gnome-initial-setup/password-creation.png
      :scale: 50%
      :alt: Password creation
      :class: no-scaled-link

#. That's it!

   .. image:: ../img/gnome-initial-setup/setup-finished.png
      :scale: 50%
      :alt: Ready To Go
      :class: no-scaled-link

#. You will be logged out once you click the **Start Using PureOS** button.
   In the login screen, you can type in your account password you set-up in step 9 to log in to your desktop.
   However, it is recommended to first restart your device.