====== Installing OpenPlotter on Raspberry Pi 5 ======

This guide will walk you through the process of installing OpenPlotter on a Raspberry Pi 5. OpenPlotter is a powerful, open-source platform for marine navigation and vessel monitoring.

===== Prerequisites =====

  * Raspberry Pi 5
  * MicroSD card (16GB or larger recommended)
  * Power supply for Raspberry Pi 5
  * Internet connection
  * (Optional) Display, keyboard, and mouse for direct interaction
  * UBS GPS Dongle 
  * RTL-SDR Dongle


===== Step 1: Download the OpenPlotter Image =====

  - Visit the official OpenPlotter website: https://openplotter.readthedocs.io/
  - Navigate to the "Downloads" section
  - Download the latest OpenPlotter image compatible with Raspberry Pi 5

===== Step 2: Flash the Image to MicroSD Card =====

  - Use a tool like Raspberry Pi Imager or balenaEtcher to flash the OpenPlotter image to your MicroSD card
  - Insert the flashed MicroSD card into your Raspberry Pi 5

===== Step 3: Boot Up and Initial Configuration =====

  - Connect your Raspberry Pi 5 to a power source
  - If using a display, connect it along with a keyboard and mouse
  - Allow the system to boot up (this may take a few minutes on first boot)

===== Step 4: Update the System =====

Once booted, open a terminal and run the following commands:

<code>
sudo apt update
sudo apt upgrade -y
</code>

===== Step 5: Install OpenPlotter =====

Run the following command to install OpenPlotter:

<code>
sudo apt install openplotter
</code>

===== Step 6: Launch OpenPlotter =====

After installation, you can launch OpenPlotter by running:

<code>
openplotter
</code>

===== Step 7: Configure OpenPlotter =====

  - The OpenPlotter configuration tool will open
  - Go through each section to set up your preferences:
    * Serial devices
    * Network
    * Signal K
    * OpenCPN (if not already installed)

===== Step 8: Install Additional Apps =====

OpenPlotter allows you to install various apps. To do this:

  - In the OpenPlotter main menu, select "Apps"
  - Choose the apps you want to install
  - Click "Install" for each selected app

===== Step 9: Configure Networking =====

If you need to set up Wi-Fi:

<code>
sudo raspi-config
</code>

Navigate to "System Options" > "Wireless LAN" and follow the prompts.

===== Step 10: Update OpenPlotter =====

Regularly update OpenPlotter and its components:

<code>
sudo apt update
sudo apt upgrade -y
openplotter-settings
</code>

In the OpenPlotter settings, check for updates to individual OpenPlotter apps.

===== Troubleshooting =====

If you encounter issues:

  - Check the OpenPlotter documentation: https://openplotter.readthedocs.io/
  - Visit the OpenPlotter forum: https://forum.openmarine.net/
  - Ensure all connections are secure
  - Verify your power supply is adequate for Raspberry Pi 5

===== Conclusion =====

You have now successfully installed OpenPlotter on your Raspberry Pi 5. Explore the various features and apps to customize your marine navigation system.

Remember to keep your system updated and regularly back up your configurations.

{{tag>openplotter raspberry-pi installation marine-navigation}}