- Ubuntu Server ISO Extraction Bug Fix for Cubic
- Introduction
- Install supplied pre-built package
- Building from source
- Ubuntu ISOs tested
- Files modified
- Authors
- Official Cubic Repo
Cubic (Custom Ubuntu ISO Creator) is a GUI wizard to create a customized Live ISO image for Ubuntu and Debian based distributions.
As of February 27, 2025, the official Cubic tool (version 2024.09) is unable to properly extract and process Ubuntu Server ISOs.
After extracting around 50% mark, it fails with an error message:
Error: Unable to extract the compressed Linux file system.
I created this fix because I needed to create a custom Ubuntu Server ISO for a project and discovered the bug.
This fix is provided as a temporary solution for those experiencing issues with Ubuntu Server ISO extraction. We will discontinue maintenance of this fix once the bug is fixed in the official Cubic codebase. If you have any questions or issues with this fix, please open an issue.
This document describes a bug in Cubic Issues that prevents proper extraction of Ubuntu Server ISOs and the solution we implemented. The issue occurs because Ubuntu Server ISOs have a two-part squashfs structure consisting of a base file (ubuntu-server-minimal.squashfs) and a secondary overlay file (ubuntu-server-minimal.ubuntu-server.squashfs). Cubic was only successfully extracting the first file and failing on the second, resulting in a non-functional ISO missing important components like WiFi drivers.
NOTE The package does not work properly on Ubuntu 24.04.2 LTS desktop. The symptom is cubic will not pop the dialog to enter sudo password and due to this, the size of ISO will be much smaller and will not install. It is due to 24.04 has replaced policykit-1 with polkitd. Try Ubuntu 22.04 in the meantime. I will fix it when I get some time. (May-11-2025)
-
A pre-built package is available for your convenience. Please download it from the Releases page. If you want to build the package yourself, please look at the Building from source section.
-
Install the package:
sudo dpkg -i cubic_2024.09_all.deb
-
Then install any missing dependencies
sudo apt install -f
-
Open a Terminal and type
cubic. Then follow the cubic documentation.
Note: During the ISO customization process, at approximately 50% of the progress, you'll be prompted with a password dialog. This dialog appears because Cubic needs elevated privileges to extract the squashfs filesystem, which contains the Ubuntu system files. The tool uses pkexec (a PolicyKit application) to run the extraction command with root permissions. You should enter your own sudo password when prompted. This security measure ensures that only authorized users can modify system files, as filesystem extraction and manipulation require administrative access.
NOTE The build package does not seem to work if built on ubuntu 24.04.2. You will see a message:
E: cubic: depends-on-obsolete-package Depends: policykit-1 (>= 0.105) =>
polkitd and optionally pkexec
It is due to 24.04 has replaced policykit-1 with polkitd. Try ubuntu 22.04 in the mean time. I will fix it when get some time. Therefore, try Ubuntu 22 in the mean time. (May-11-2025)
If you need to build the package yourself: install all dependencies first. Look at cubic/debian/control for details.
Clone this repo first, then follow the steps:
Look at install_deps.sh. Install the dependencies:
$ ./install_deps.sh
Look at the build.sh script. Build the package:
$ ./build_cubic.sh
Check if the debian package is created or not
$ /bin/ls -lt ..
total 264
drwxrwxr-x 5 muquit muquit 4096 Feb 26 23:04 cubic
-rw-r--r-- 1 muquit muquit 1931 Feb 26 22:27 cubic_2024.09_amd64.build
-rw-r--r-- 1 muquit muquit 29028 Feb 26 22:27 cubic_2024.09_amd64.changes
-rw-r--r-- 1 muquit muquit 16705 Feb 26 22:27 cubic_2024.09_amd64.buildinfo
-rw-r--r-- 1 muquit muquit 207850 Feb 26 22:27 cubic_2024.09_all.deb
^^^^^^^^^^^^^^^^^^^^^
If the build is successful, the package cubic_2024.09_all.deb will be created.
Look at the install.sh script. Install the built debian package:
$ ./install_cubic.shNote: The original code was copied from the official Cubic repository at https://code.launchpad.net/cubic using
$ bzr branch lp:cubicPlease look at Files modified for details on what is changed.
This fixed version of Cubic has been successfully tested with the following official Ubuntu ISOs:
| ISO | MD5 Sum |
|---|---|
| ubuntu-24.10-desktop-amd64.iso | ea0baab241893d4f2b679e7179009e1c |
| ubuntu-24.10-live-server-amd64.iso | eb5509ce027f207cfed6dbce6000dd2b |
| ubuntu-24.04.2-desktop-amd64.iso | 094aefdb1dbbdad8aa99600f8413789b |
The fixed Cubic binary was run on Ubuntu 24.04.2 LTS to create the custom ISOs from both desktop and server images. Both resulting custom ISOs installed successfully, confirming that the fix works for both Ubuntu Desktop and Server ISO types.
For Ubuntu Server ISOs, the fix properly extracts both squashfs files, ensuring all components (including WiFi drivers and other server-specific components) are included in the final customized ISO.
Note: While the ISO now builds successfully, there may still be issues with WiFi functionality during installation if not connected to Ethernet. This appears to be a separate issue from the extraction problem.
File modified: ./cubic/usr/share/cubic/cubic/pages/extract_page.py
extract_page.py: Changed the extract_squashfs() function to handle overlay files differently
When attempting to customize an Ubuntu Server ISO with Cubic, the extraction process would fail with the error: Error: Unable to extract the compressed Linux file system. This happened because:
- Ubuntu Server ISOs use a different structure than Desktop ISOs, with two squashfs files that need to be combined
- The original extraction method in Cubic was not designed to handle overlay squashfs files
- The second file was failing to extract properly due to conflicts with files from the first extraction
We modified Cubic's extraction process to handle both squashfs files differently:
- For the first file: Use the standard extraction process
- For the second file: Extract to a temporary directory, then selectively copy new files to the target
The key improvements in our solution:
- Split Processing: Detects if it's handling the first file or a subsequent file using the
file_numberparameter - Different Extraction Methods:
- First file: Uses the standard
extract-rootcommand - Second file: Creates a bash script that:
- Extracts the overlay squashfs to a temporary directory
- Uses rsync with
--ignore-existingto copy only new files - Excludes problematic directories (
/dev,/proc,/sys) - Cleans up temporary files
- First file: Uses the standard
- Progress Reporting: Splits the progress bar (0-50% for first file, 50-100% for second)
- Error Handling: Properly handles errors and ensures temporary files are cleaned up
The fix is developed collaboratively with Claude AI 3.7 Sonnet, working under my guidance and instructions. The AI assisted in diagnosing the issue, developing multiple solution approaches, and refining the code to properly handle Ubuntu Server's two-part squashfs structure.
If you use this fix, please consider submitting it to the Cubic developers to help improve the original software.
This file is assembled from docs/*.md with markdown_helper