[[PageOutline]]

= Ubuntu on Malibu
This page provides details on running Ubuntu on a Gateworks Malibu Board.

Other references:
 * The Gateworks [wiki:malibu Malibu] software page
 * [wiki:/ubuntu Gateworks Ubuntu Page for generic Ubuntu notes not specific to Malibu]


[=#prebuilt]
== Gateworks pre-built Ubuntu based Disk Images for Malibu
Gateworks provides a pre-built Ubuntu based firmware images for the Malibu Family:
 * [http://dev.gateworks.com/malibu/images/jammy-malibu.img.gz jammy-malibu.img.gz] Ubuntu 22.04 (Jammy) based root filesystem image for CN913x
  * To update the firmware on the eMMC see [wiki:malibu/firmware#serial-ethernet]
  * To update the firmware on a microSD card see [wiki:linux/blockdev#UsingaDiskImage]
 * [http://dev.gateworks.com/malibu/kernel/linux-malibu.tar.xz linux-malibu.tar.xz] - Compressed TAR archive of pre-built Linux kernel
 * [http://dev.gateworks.com/ubuntu/jammy/jammy-malibu.tar.xz focal-arm64.tar.xz] - Compressed TAR archive of Ubuntu 24.04 Jammy arm64 root filesystem (does not include kernel)([http://dev.gateworks.com/ubuntu/jammy/jammy-malibu.manifest package manifest])

'''Login Information (default)'''
 * Username: root
 * Password: root

Features:
- Ubuntu aarch64 core
- Gateworks Malibu Linux kernel
- eth0 dhcp with a 10 second timeout
- User: root password: root
- Packages installed on top of core including:
 * Updated modemmanager/libqmi-utils/libmbim-utils (see [wiki:ubuntu#modem ubuntu/modem])
 * Misc wireless: wpasupplicant iw 
 * Misc utils: vim can-utils i2c-tools usbutils pciutils screen watchdog binutils
 * Misc network: wget ethtool iperf iperf3 openssh-server iptables
 * Linux firmware
 * Gateworks [https://raw.githubusercontent.com/Gateworks/meta-gateworks/master/recipes-support/hostapd-conf/hostapd-conf/hostapd-conf hostapd-conf script]
 * Filesystem tools: e2fstools parted
- first-boot script to grow root filesystem partition and filesystem (useful when putting disk images on removable storage devices)
- use ifupdown tools instead of netplan (we find them easier to understand and configure)


To install the kernel and root filesystem on a removable block storage device see [#disk-images below].

== BSP 
To build a complete Ubuntu image, including all the boot firmware, start with the [wiki:malibu/bsp Malibu BSP] page as the easiest option.