OS Installation and Configuration (RPI) - Offset-official/Nautilus-One GitHub Wiki

These instructions will get your Raspberry Pi operating system set up and configured. Software install instructions can be found here.

Prerequisites

Before starting, ensure the following:

  • Your laptop is configured with:

    • IP Address: 192.168.2.1
    • Subnet Mask: 255.255.255.0

  • You have access to the necessary repositories and tools:

If you're building a new image from scratch, follow these steps:

Setting Up Raspberry Pi OS

  1. Download the Raspberry Pi OS
    Get the 32-bit or 64-bit Raspberry Pi OS image from the Navigator-Lib Repository.

  2. Flash the OS Image
    Use the Raspberry Pi Imager to flash the downloaded image onto an SD card. After flashing, enable SSH access if needed.

  3. Run the following to set up the overlay required for Navigator.

    sudo su -c 'curl -fsSL https://raw.githubusercontent.com/bluerobotics/blueos-docker/master/install/boards/configure_board.sh | bash'
sudo reboot

  4. Reboot Navigator and run the following command to set up BlueOS.

    sudo su -c 'curl -fsSL https://raw.githubusercontent.com/bluerobotics/BlueOS/master/install/install.sh | bash'

  5. Log in to Navigator using [email protected]

  6. Verify BlueOS and Docker Containers
    Once logged in to the Raspberry Pi, confirm that the BlueOS Core and Docker containers are running. Use the following command:

    docker ps -a

  7. Access blueos.local on a browser of choice.

    Some browser don't support natively access to the BlueOS dashboard. Either be a developer or switch browser like a lazy man that I am. 😅

Ubuntu (Not Yet Supported)

Our current system is based on Raspberry Pi OS. We found it particularly difficult to get Ubuntu working with the BlueOS system. This is a work in progress, and we are working on getting it to work. If you are interested in helping us with this, please reach out to us.

Notes

  • We are currently using a Raspberry Pi 4 Model 4B (4GB), with raspios-lite (32 or 64 bit). Other boards and OS's may work, but the instructions on this wiki only cover that specific hardware, and that specific OS.
  • BlueOS 64 bit support is in developmental phase. Although we have it working, if you find any difficulties getting the environment set up, please start with 32 bit. This way you can get the system up and running, and then can work on getting 64 bit working.
  • If you make a new image, make sure to save the image for future use. It's really easy for these MicroSD cards to get corrupted, so make sure you've got a backup.