A lean Linux OS distribution for Raspberry Pi
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
apks @ 250b016
.gitignore
.gitmodules
BUILD.md
LICENSE
Makefile
README.md
build-template.sh
pack-image.sh
repositories

README.md

FruitOS

Latest version: 0.4.7.

A lean Linux OS distribution for Raspberry Pi, developed based on Alpine Linux, featuring:

  • A/B Root Partitions
  • Over-the-Air update
  • Remote configuration managements
  • Support Docker and Singularity containers

FruitOS image files can be downloaded from: https://fruit-testbed.org/os/images/

Supported boards:

Setup Raspberry Pi

  1. Install fruit-cli through Python Pip:

    $ pip install fruit-cli
  2. Register your account by following the instructions.

  3. Download a FruitOS image that is suitable for your Raspberry Pi, and burn it on an SD card using Etcher or dd.

  4. Make a note of your new account's public key by running fruit-cli account public-key. You will need it in the next step.

    $ fruit-cli account public-key
    aNsXAGLzB3C5j-tQSl4McNzVjqeegY4TKbDCeFYCUvc
  5. Mount the boot partition of the SD card (label: FRUITOS, filesystem: FAT32), and open file fruit.json with a text editor. Put your public key into field public-key and save the change. Close the file and unmount the SD card.

  6. Mount the SD card to your Raspberry Pi, then power it up. If the configurations are correct, then the OS will automatically register the node to the management server. You can check it by listing the registered node using:

    $ fruit-cli node list

    To get the IP address of your Raspberry Pi, look at the network field of the output of fruit-cli node monitor:

    $ fruit-cli node monitor --node <pi-node-id>

    You can automate this by using a tool such as jq:

    $ fruit-cli --json node monitor --node <pi-node-id> | jq 'to_entries[].value.network'

Accessing Raspberry Pi

Every Raspberry Pi can be accessed through:

  1. Serial console, by connecting monitor and keyboard to Pi's display and USB ports respectively. The default username is root without password.

  2. SSH with public key authentication (password-authentication is disabled). You can use fruit-cli to add your public key to the management server:

    $ fruit-cli key add --keyfile <my-public-key-file>

    Afterwards, the management server will distribute the public key to your Raspberry Pis so that you can SSH (username: root):

    $ ssh -i <my-private-key-file> root@<pi-address>