Skip to main content

F.A.Q.

Deutsch  •  English  •  Español  •  Français  •  Italiano  •  Polska  •  Portuguese  •  Български  •  Русский  •  Українська  •  やまと  •  中国  •  فارsi

1. What is Penguins' Eggs?​

Penguins' Eggs is a tool to create live ISO images and custom Linux respin. Initially based on Debian/Ubuntu and derivatives, actually support almost all major original distros and derivatives. It allows you to generate reproducible systems or "hatch" new respin. It is also possible to use penguins-eggs to create secure, virtually unbreakable live systems using the --fullcrypt option.

2. What are the distros supported?​

penguins-eggs is compatible with Almalinux, Arch, Debian, Devuan, Fedora, OpenSUSE, Rocky and Ubuntu and most of derivatives. You can find a complete listo on supported distros.

3. How do I install penguins-eggs?​

Use fresh-eggs, universal installer:

git clone https://github.com/pieroproietti/fresh-eggs
cd fresh-eggs
sudo ./fresh-eggs.sh

The fresh-eggs.sh script will:

  • automatically detect your distribution;
  • install the appropriate version of Node.js (≥18) if needed;
  • download and install the correct penguins-eggs package for your system;
  • configure all necessary dependencies.

4. Common Issues & Fixes

"Permission denied" when running sudo eggs:

  • check user permissions and ensure the user is in the sudo group;
  • ISO generation errors: Verify required packages (e.g., squashfs-tools, xorriso) are installed.

5. How do I create a custom live ISO?​

Type:

sudo eggs produce

This generates an ISO image in /home/eggs/.

6. Where’s the full documentation?​

Check the official User's guide on the penguins-eggs.net website.

Other inmportants documents, can be found on the penguins-eggs, look expecially README.md and under DOCS.

7. Use cases​

  • create personalized Linux customizations for organizations with pre-installed software and configurations;
  • build rescue/recovery systems with your preferred tools and settings.
  • develop educational Linux environments for classrooms with specific software packages;
  • create portable development environments that can be deployed consistently across different machines;
  • build specialized penetration testing or system administration live distributions;
  • secure, virtually unbreakable live systems.

8. Can I use penguins-eggs without sudo?​

No, certain operations require root privileges to mount filesystems and modify system settings.

9. How can I contribute?​

  • report bugs/requests via GitHub Issues.
  • contribute code via Pull Requests.
  • help with translations (check i18n-labeled issues).
  • share the project and don't forget to leave a star to it on github.

10. GUI​

eggsmaker - a project of Jorge Luis Endres - It is an essential and functional Graphical User Interface for penguins-eggs. Available for Arch, Debian, Devuan and Ubuntu.

Relevant Issues (for deeper insights)​

Consult issues