https://github.com/pieroproietti/penguins-eggs
On the road of Remastersys, Refracta, Systemback and father Knoppix!
https://github.com/pieroproietti/penguins-eggs
almalinux alpine amd64 arch arm64 btrfs debian devuan fedora i386 installer live manjaro openmamba pxe remaster rockylinux ubuntu
Last synced: 20 days ago
JSON representation
On the road of Remastersys, Refracta, Systemback and father Knoppix!
- Host: GitHub
- URL: https://github.com/pieroproietti/penguins-eggs
- Owner: pieroproietti
- Created: 2017-10-22T04:57:33.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-05-09T20:02:20.000Z (26 days ago)
- Last Synced: 2025-05-09T21:20:19.956Z (25 days ago)
- Topics: almalinux, alpine, amd64, arch, arm64, btrfs, debian, devuan, fedora, i386, installer, live, manjaro, openmamba, pxe, remaster, rockylinux, ubuntu
- Language: TypeScript
- Homepage: https://penguins-eggs.net
- Size: 174 MB
- Stars: 447
- Watchers: 8
- Forks: 54
- Open Issues: 7
-
Metadata Files:
- Readme: DOCS/README.md
- Changelog: CHANGELOG.D/changelog-eggs-v7.x.x.md
Awesome Lists containing this project
- awesome-starred - pieroproietti/penguins-eggs - On the road of Remastersys, Refracta, Systemback and father Knoppix! (TypeScript)
- awesome-starred - pieroproietti/penguins-eggs - On the road of Remastersys, Refracta, Systemback and father Knoppix! (TypeScript)
README
# Develop eggs on various distros
To start hacking with penguins-eggs, you have four ways, one for every family: debian, arch, alpine and fedora. The best is starting with Debian or Arch, where eggs is complete, reproductive and is possible to create packages. Alpine and fedora are unfinished, not reproductive yet and lacks packaging.
Basically you need to have:
- an editor, I use `code`, but it's your choice
- `git`
- `nodejs`
- `pnpm`
- install eggs dependencies
**Note**: While not essential, it is strongly recommended to fork penguins-eggs to have your own repository
## fork penguins-eggs
This operation is not essential but is strongly recommended as it allows us to have our own version of penguins-eggs and save our work in our git repository.
The operation is rather simple, requiring us to log in at https://github.com, so we first register.
In our example we will register with the name `jtburchett`
Then we will go to the project [penguings-eggs](https://github.com/pieroproietti/penguins-eggs) and click on the `fork` button.
We will get our version of penguins-eggs at https://github.com/jtburchett/penguins-eggs.
# Historical perspective
I suggest to think how this is a software grow up with time, so think the history of it to understand a reason.
I started just with Debian and remastering Debian, then extend to Ubuntu and Devuan. In origin I have not `deb` package but produce `npm` packages for node, so inside eggs where was the code to install all the packages dependencies.
With time, I passed to create deb packages more pratical for users and at last also for me. I started to create deb packages using [oclif](/incubation/incubator.ts`), but oclif don't manage dependencies nor pre and post install scripts.
To exit to this impasse, I wrote [perrisbrewery](https://github.com/pieroproietti/perrisbrewery), so I can insert dependecies and scripts inside the package. This lead me to remove same code I had inside the sources about install dependencies.
Removing dependencies from code free me a bit: in this way I can manage them in the package not in the sources.
Then was more easy to extend eggs to Arch, where the dependeces are included in the PKGBUILD scrips. Of course, was not so short step, involved initramfs, different paths, differents packages names and so on.
After that where was a time of relative stability, nodejs was included in the package eggs from oclif.
With version 10.x.x come the decision to not include more nodejs inside eggs, but to have it as dependence.
Actually, I started to extend eggs to [AlpineLinux](https://alpinelinux.org/) and [fedora](https://fedoraproject.org/it/).
# SOURCES
eggs is written using typescript, bash, and yaml files.
## Typescript
All the typescript sources are under [src](../src/) here there is a mockup of [Documentation](./SOURCE.md).
## Bash
Bash is largely used inside Typescript and alone: [scripts](../scripts/),
## YAML
All the configurations are in YAML, inside [conf](../conf/) for eggs, krill and calamares.
# Differents ways
## [Way to Debian](./WAY-TO-DEBIAN.md)
## [Way to ArchLinux](./WAY-TO-ARCHLINUX.md)
## [Way to AlpineLinux](./WAY-TO-ALPINE.md)
## [Way to Fedora](./WAY-TO-FEDORA.md)