shadil-rayyan/cubic_iso_guide
This is a cubic guide which i learned from various source and in the hard way
Cubic ISO Guide
Overview
Cubic ISO Guide is a comprehensive, step-by-step guide for building and customizing Ubuntu-based ISO images using Cubic.
This project covers everything from installing Cubic, working in chroot, managing the custom-root filesystem, adding GNOME extensions, wallpapers, Plymouth boot images, desktop icons, GRUB tweaks, ISO compression, and legal considerations.
This documentation is designed to help both beginners and advanced users create fully customized Ubuntu ISOs while keeping workflows clean and professional.
Features
- Step-by-step instructions for Cubic and Custom Root workflows
- Detailed explanations of Linux filesystem paths used in ISO customization
- Guides for GNOME extensions, desktop icons, wallpapers, and Plymouth boot/login images
- ISO compression and GRUB configuration tips
- Legal and licensing considerations for branding
- Ready for live-build alternatives if needed
- Fully documented with screenshots and diagrams
Table of Contents
See the MkDocs navigation for full content, including:
- Chroot Basics
- Linux Filesystem Overview
- Legal Considerations
- Cubic Installation and ISO Customization
- Custom Root Workflow
- Desktop Icons, Extensions, Plymouth, Wallpapers
Installation
1. Clone the repository
git clone https://github.com/yourusername/cubic_iso_guide.git
cd cubic_iso_guide2. Install dependencies
pip install -r requirements.txtMake sure you are using Python 3 and your virtual environment is activated.
3. Serve locally
mkdocs serveThen open http://127.0.0.1:8000 in your browser to preview the documentation.
Building the Site
To generate the static site:
mkdocs buildThe HTML output will be in the site/ directory, ready to deploy.
Contributing
Contributions are welcome! Please fork the repository, create a branch for your changes, and submit a pull request.
License
This project is licensed under the MIT License. See LICENSE for details.