Sony Xperia XZ (F8331 / Kagura) Porting

  • @sjll Thanks for your help. Do links to the tree for Xperia X Performance?

  • @sjll I just realized that I think you made this as well:

    This tree would be helpful to make the Ubuntu Touch port I think, but I couldn't find a github link.

    Thank you!

  • I wonder if you can treblize the XZ:

    Then you might be able to install the Ubuntu Touch GSI:

  • Looks like Konrad has pretty much completed this port!

    The manifest has been requested to be merged into halium.

    Hoping to build the images and see how it goes...

  • Keep me updated as I was away for a while doing some other activities..

  • @ressan627 I was able to get it running on Kagura thanks to Konrad's help.


    • No camera. Even with gstreamer
    • Graphical performance is a bit sluggish
    • No fingerprint reader
    • Wifi won't automatically connect after reboot
    • Phone reboots when plugged into usb attached to computer
    • Using suru dark system theme causes text fields in browser to be all black with black text (i.e. unreadable)
    • No flashlight

    This device may show up in the installer some time, but here is what I did to get it running. Pieced together from , and some documents from the telegram group: @ubports_porting

    Building and Installing

    If you don't want to build the images yourself, then contact me and I can find a way to send them to you.

    Porting Environment

    sudo dpkg --add-architecture i386

    sudo apt update

    sudo apt install git gnupg flex bison gperf build-essential \
      zip bzr curl libc6-dev libncurses5-dev:i386 x11proto-core-dev \
      libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-glx:i386 \
      libgl1-mesa-dev g++-multilib mingw-w64-i686-dev tofrodos \
      python-markdown libxml2-utils xsltproc zlib1g-dev:i386 schedtool \
      repo liblz4-tool bc lzop imagemagick libncurses5 rsync

    The problem with 20.04 is that repo doesn't exist in the repositories. You will have to install the package and dependency from eoan.

    Download packages:
    downloaded the packages manually:

    python-kerberos from
    repo from

    I then installed them using sudo dpkg -i <filename>, python-kerberos first.

    It may complain about python version, but it will work.

    Get Halium Source

    This takes a long time and a lot of space (~15GB).

    mkdir halium && cd halium

    repo init -u -b halium-7.1 --depth=1

    repo sync -c -j 16


    For Kagura the manifest is now part of halium source. So you don't need to do anything here.

    But for reference, this is what needs to be done for devices not included.
    // You need to make sure the correct manifest for the devices is in:
    // /halium/halium/devices/manifests

    // If you don't have a manifest, then you will have to create it for your device:

    Get Devices Source

    First get devices source (pulled from info in manifest)
    ./halium/devices/setup kagura --force-sync
    // had to use force-sync or no kernel folder would show up

    Fix Mounts

    Not sure. Seems not applicable to kagura

    Kernel Check

    Run Kernel check for Ubuntu Touch
    ./halium/halium-boot/check-kernel-config kernel/sony/kagura/arch/arm64/configs/aosp_tone_kagura_defconfig -w

    Also ran on :
    ./halium/halium-boot/check-kernel-config kernel/sony/kagura/arch/arm64/configs/defconfig -w

    It will fix a few things. Run it again until everything is fixed.


    Build the image

    Once halium-boot is in place, you can build it quite simply. You will also need to rebuild system.img due to our changes.

    cd to your Halium BUILDDIR
    source build/
    Run `lunch` and select the correct device
    `mka halium-boot`
    `export USE_HOST_LEX=yes` // fixes an error 
    `mka systemimage`

    Anothe 15GB or so are needed to build these things.

    Installing Ubuntu Touch

    Get Halium-Install

    Clone this repository

    Install dependencies: sudo apt install [those packages below]

    Download rootfs:

    Install Halium:
    ./path/to/halium-install -p ut path/to/rootfs.tar.gz path/to/system.img // using the correct paths and changed root password

    After install. Reboot.

    Do some fixes and updates

    NOTE: I'm not sure if all this needs to be done before flashing the tone file (See last step. That might actually work as is) but if not.

    Device should boot, show a purple indicator light briefly, and then hang at the Sony logo. It is actually booted at the moment.
    There should be a new wired connection that shows up on the connected computer. When that shows "connected" you can ssh to the phone.


    ssh phablet@

    // sometimes requires a reboot first

    Connect to wifi:


    Make device writable:

    sudo mount -o remount,rw /

    Edit and update:

    sudo -i

    Add Udev rules:

    cat /var/lib/lxc/android/rootfs/ueventd*.rc|grep ^/dev|sed -e 's/^\/dev\///'|awk '{printf "ACTION==\"add\", KERNEL==\"%s\", OWNER=\"%s\", GROUP=\"%s\", MODE=\"%s\"\n",$1,$3,$4,$2}' | sed -e 's/\r//' >/usr/lib/lxc-android-config/70-kagura.rules

    Install xenial arm 64 stuff:

    ubports-qa install xenial_-_arm64

    apt update && apt upgrade

    apt install mir-platform-graphics-android-caf15

    Change Lib path

    nano /etc/environment
    edited to LD_LIBRARY_PATH=/vendor/lib64:/system/lib64

    Platform Apis

    NOTE: I think NOT doing this allows the light sensor to work. Not sure which option is better.

    comment out the if and fi in /usr/share/upstart/sessions/unity8.conf

    # if [ ! -f /system/lib/ ]; then
    initctl set-env --global
    initctl set-env --global UBUNTU_PLATFORM_API_SENSOR_TEST=/etc/ubuntusensors/test.sensors
    # fi

    Flash the Tone file

    This is a key step to actually boot into Ubuntu Touch


    Boot to bootloader

    fastboot flash oem [filename]

  • This post is deleted!

  • It's in the installer now. Maybe this thread can be closed?

  • @joe said in Sony Xperia XZ (F8331 / Kagura) Porting:

    It's in the installer now. Maybe this thread can be closed?

    Or maybe you can let it open for support purposes ^^

  • @Keneda Good thinking!

    Here's the updated video:

Log in to reply