Install Linux microPlatform¶
The Linux microPlatform is split into two parts:
A base system, which is built using OpenEmbedded / Yocto. It provides a minimal runtime for application development which is over the air updatable.
Applications, which are developed and deployed as containers running on the base system. Application updates are accomplished by running updated containers. Currently, Docker containers are supported.

Linux microPlatform¶
This document describes how to install base system onto your device.
Important
Make sure you’ve obtained dependencies as described in Dependencies before continuing.
Install Base microPlatform¶
You’ll start by installing the base microPlatform and connecting to your device’s console.
This document provides instructions for the Raspberry Pi 3 models B and B+ reference development boards. If you are using a different board, or want to build from source then see Additional Linux microPlatform Targets and Building the Linux microPlatform in the reference manual.
Get Prebuilt Image
Update 55 can be downloaded here:
Flash Image To SD Card
The Raspberry Pi foundation recommends using the the cross-platform Etcher tool to flash images onto the SD card you’ll use to boot your Raspberry Pi 3.
After you’ve installed Etcher on your system:
Attach an SD card onto your host computer. Refer to this Embedded Linux wiki guide for a list of SD cards compatible with Raspberry Pi 3.
Run Etcher, and select the pre-built Linux microPlatform image you downloaded on your file system.
Select the SD card you mounted from Etcher, and flash it.
More detailed guides are available for macOS, Windows, and Linux.
Boot Raspberry Pi 3 and Connect to the Network
Choose a method:
- Ethernet (Recommended)
- WiFi
Ethernet works out of the box if a DHCP server is available on the local network.
Connect an Ethernet cable to the Raspberry Pi 3.
Remove the SD card from your computer, and insert it into the Raspberry Pi 3.
Apply power to the Raspberry Pi 3.
Your board will connect to the network via Ethernet. The board should be ready to connect within a minute or two of booting.
Log in via SSH
Use fio
as the username and raspberrypi3-64.local
as the
hostname:
ssh fio@raspberrypi3-64.local
The default password is fio
; we recommend changing it now if you
haven’t already. For this to work, your local network needs to support
Zeroconf1 and the hostname must be otherwise unclaimed.
If that doesn’t work, you can also log in by IP address. See Troubleshooting below for advice.
Finish Installation
Once you have an SSH console connection, finish your installation by setting up aktualizr-lite. Follow instructions in Use Linux microPlatform for a demonstration.
Troubleshooting
If the above methods to connect your Raspberry Pi 3 to the network don’t work, try one of the following.
Temporarily enable and connect to the UART (see directions above in the WiFi section) and determine available IP addresses with:
# Ethernet ip addr show eth0 scope global # WiFi ip addr show wlan0 scope global
Then connect by IP address:
ssh fio@rpi3.ip.addr.ess
List connected devices and their local IP addresses on your network router’s administrative interface, and log in by IP address as above.
Test Your Connection¶
Test your Linux microPlatform device’s network connection any way you would like. For example:
ping -c 3 foundries.io
Reporting Issues¶
Please report any issues to the Foundries.io Support Portal.
Footnotes
- 1
Zeroconf is a set of technologies that allows automatic discovery of systems and services available on a local area network. It helps by assigning a local address name (e.g.
hostname.local
instead of192.168.1.10
), which can be used by other Zeroconf compatible services like Bonjour on macOS.Avahi, a free Zeroconf implementation, is available by default on the Linux microPlatform, making it easy for other Zeroconf-compatible hosts to locate the IP address assigned to the board.
To use Zeroconf, simply use
hostname.local
in place of the board’s IP address when that is needed.