.. note::

    Hello, welcome to the SunFounder Raspberry Pi & Arduino & ESP32 Enthusiasts Community on Facebook! Dive deeper into Raspberry Pi, Arduino, and ESP32 with fellow enthusiasts.

    **Why Join?**

    - **Expert Support**: Solve post-sale issues and technical challenges with help from our community and team.
    - **Learn & Share**: Exchange tips and tutorials to enhance your skills.
    - **Exclusive Previews**: Get early access to new product announcements and sneak peeks.
    - **Special Discounts**: Enjoy exclusive discounts on our newest products.
    - **Festive Promotions and Giveaways**: Take part in giveaways and holiday promotions.

    👉 Ready to explore and create with us? Click [|link_sf_facebook|] and join today!

.. _install_rpi_os:

Install the Raspberry Pi OS
======================================

An operating system needs to be installed onto the Micro SD card before inserting it into the Raspberry Pi.

#. Browse to the Raspberry Pi Imager site and download the version that matches the computer or laptop's operating system (www.raspberrypi.org/software). When the download is complete, launch the installer program and follow the prompts to install the Raspberry Pi Imager.

    .. image:: img/3d1.png
      :align: center

#. If the Windows operating system prevents the application from launching, click on **More info** and then click on **Run anyway** to install the Raspberry Pi Imager.

    .. image:: img/3d2.png
      :align: center

#. Insert the Micro SD card into the computer or laptop's SD card slot. If the computer or laptop only has a full-size port for SD cards, use a Micro SD card adapter.


#. In the Raspberry Pi Imager, click **CHOOSE OS** -> **Raspberry Pi OS(Legacy)**.

    .. warning::

      * Please do not install the **Bookworm** version to avoid the **double-click** function and the **virtual keyboard** not working.
      * You need to install the **Raspberry Pi OS (Legacy)** version - **Debian Bullseye**.
      * Additionally, for a perfect touch experience, it is recommended to install the **Ubuntu** system.

    .. image:: img/3d33.png
        :align: center


#. Select the SD card you are using.

    .. image:: img/3d4.png
      :width: 550
      :align: center

#. To open the advanced options page, click the **setting** button (appears after selecting operating system) or press **Ctrl+Shift+X**. Now, set hostname, enable ssh and set the username and password.

    .. warning::

        Make sure to note down the ``hostname``, ``username``, and ``password``; they're crucial for later remote access to the Raspberry Pi.

    .. image:: img/image15.png
        :align: center

#. Then scroll down to complete the wifi configuration and click **SAVE**.

    .. note::

        **wifi country** should be set the two-letter `ISO/IEC alpha2 code <https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements>`_ for the country in which you are using your Raspberry Pi, please refer to the following link: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements

    .. image:: img/image16.png
        :align: center


#. Click the **WRITE** button.

    .. image:: img/3d7.png
      :width: 550
      :align: center

#. The Imager will overwrite any files already on the SD card. If the SD card has any files, back up these files before clicking Yes.

    .. image:: img/3d8.png
      :width: 550
      :align: center

#. After the Imager completes installing the Operating System on the SD card, click Continue to complete the installation.

    .. image:: img/3d9.png
      :width: 550
      :align: center

#. Now insert the Micro SD card with the system installed into the Raspberry Pi.