[[PageOutline]]

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

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


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

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

Features:
- Ubuntu aarch64 core (created via debootstrap)
- Gateworks Venice 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].

Notes:
 * '''By default root ssh access is disabled for security'''. See [wiki:/ubuntu#SSHServer This link] for info on enabling it

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

== Root Filesystem
see [wiki:ubuntu]

[=#disk-images]
== Building a Bootable Disk Image ==
You will want to build your own Ubuntu disk image if you want control over any of the following:
 * Contents of root filesystem (packages and configuration) (see [#debootstrap debootsrap below)
 * Configuration of the Linux kernel (see [wiki:venice/bsp#kernel venice/bsp/kernel])

See [wiki:venice/firmware#disk-images venice/firmware/disk-images] for detailed instructions.