QuickStart Guide
Installation and Deployments

Raspberry Pi Installation

8min

You can install Litmus Edge on a Raspberry Pi (version 3 or 4) by using balenaEtcher (recommended for Windows, macOS, and Ubuntu) or terminal commands (for advanced users on Linux-based systems).

Note: You can't upgrade Litmus Edge versions on Raspberry Pi. You must reinstall newer Litmus Edge versions. See Backup/Restore to learn more about backing up your data and managing templates before reinstalling a newer version.

Raspberry Pi 4 Model B
Raspberry Pi 4 Model B


Before You Begin

  • Make sure you use Raspberry Pi version 3 or 4.
  • Contact [email protected] to get a Litmus Edge license.
  • Download the appropriate Litmus Edge image file (litmusedge-std_[version number]-arm64.gz) from the Litmus Central Portal.
  • You will need to format an SD card (minimum of 16GB). See the steps below.

Format SD Card

  1. Remove the SD card from the Raspberry Pi and insert it into your computer.
  2. Format the SD card to one partition using the FAT32 file system with a formatting tool such as GParted or Windows Disk Management.

Installation Using balenaEtcher

balenaEtcher is a user-friendly, graphical tool for writing images to SD cards, compatible with Windows, macOS, and Ubuntu.

To install using balenaEtcher:

  1. Download and open balenaEtcher on your computer.
  2. Click Flash from file, then select the Litmus Edge image file you downloaded.

    Flash from file option
    Flash from file option
    
  3. Click Select target and select your SD card.

    Select target option
    Select target option
    
  4. Click Flash to start, then wait for balenaEtcher to finish.

    Flash option
    Flash option
    
  5. Once balenaEtcher shows the completed screen, safely eject the SD card from your computer.

    Flash completed screen
    Flash completed screen
    
  6. Insert the SD card into the Raspberry Pi and power up the Raspberry Pi.
  7. Litmus Edge will boot and the Litmus Edge Terminal User Interface (TUI) will appear if a monitor is connected to the Raspberry Pi.

Log in to Litmus Edge

Once the Litmus Edge TUI loads, you can log in to Litmus Edge.

Installation Using Terminal

Complete the following steps to install Litmus Edge using terminal commands.

To import the LE image from the terminal:

  1. Open a terminal window.
  2. Use df -h to identify the mount point of your SD card.
  3. Copy and run the commands below with your SD card's path and the downloaded Litmus Edge image file name. Replace /dev/sde with the correct mount path, and replace litmusedge-std_3.11.0-arm64.gz with the correct file name and Litmus Edge version based on the file you downloaded.
    • The first two commands are used to set environment variables for the SD card mount and LE image file paths.
    • The third command unzips the image and writes it to the SD card.
Linux


4. Once the gzip command completes, safely eject the SD card from your computer. 5. Insert the SD card into the Raspberry Pi and power up the Raspberry Pi. 6. Litmus Edge will boot and the Litmus Edge Terminal User Interface (TUI) will appear if monitor is connected to the Raspberry Pi.

Log in to Litmus Edge

Once the Litmus Edge TUI loads, you can log in to Litmus Edge.