🚀 By-Roket LinuxServer Store for ZimaOS V2 — Automated Community App Store

Insight & Feedback
1

:rocket: By-Roket LinuxServer Store for ZimaOS V2

Automated Community App Store / Store communautaire automatisé

:united_kingdom: ENGLISH

:waving_hand: Introduction

Hello ZimaOS community,

I’m By-Roket, a Systems Administrator / IT Infrastructure Manager, with a strong interest in self-hosting, networking, Docker, virtualization and infrastructure security.

After adopting ZimaOS, I wanted to contribute to its ecosystem by improving access to reliable and regularly maintained applications while keeping the installation experience as simple as possible.

This led to the creation of:

By-Roket LinuxServer Store for ZimaOS V2

The project is already:

  • :white_check_mark: available;

  • :white_check_mark: functional;

  • :white_check_mark: open source;

  • :white_check_mark: automatically maintained;

  • :white_check_mark: compatible with the ZimaOS V2 Store format.

:one: Project Links

:link: GitHub Repository

https://github.com/By-Roket/By_Roket-ZimaOS-V2-LinuxServer-Store

:package: Public ZimaOS V2 Store

https://by-roket.github.io/By_Roket-ZimaOS-V2-LinuxServer-Store/store.json

This URL can already be used as a custom ZimaOS V2 Store source.

:two: Original Project & Credits

This project was not created from nothing.

The original foundation comes from the excellent work of WisdomSky:

WisdomSky — CasaOS LinuxServer AppStore

https://github.com/WisdomSky/CasaOS-LinuxServer-AppStore

The WisdomSky project provides a large catalog of application configurations based primarily on container images maintained by the LinuxServer.io community, adapted for CasaOS.

The By-Roket project takes this foundation and reworks the integration layer for ZimaOS V2.

The objective is not to hide or replace the original work.

Quite the opposite:

The WisdomSky project remains clearly credited as the upstream application catalog and original foundation of this work.

Many thanks to:

  • :heart: WisdomSky for the original CasaOS LinuxServer AppStore;

  • :spouting_whale: LinuxServer.io for maintaining the application container images;

  • :snowflake: IceWhale / ZimaOS for the ZimaOS platform, validator and V2 Store tooling.

:three: What Has Been Reworked for ZimaOS V2?

The original WisdomSky application definitions are designed for the CasaOS application-store ecosystem.

The By-Roket project adds an automated adaptation layer specifically for ZimaOS V2.

The workflow performs several operations:

WisdomSky App Catalog
        │
        â–Ľ
Automatic Synchronization
        │
        â–Ľ
By-Roket Conversion
        │
        â–Ľ
ZimaOS V2 Manifest
        │
        â–Ľ
IceWhale Validation
        │
        â–Ľ
Official ZimaOS V2 Builder
        │
        â–Ľ
By-Roket Public Store

This allows the project to stay close to the upstream catalog while remaining compatible with the newer ZimaOS Store protocol.

:four: Fully Automated Synchronization

One of the main goals of the project is to avoid manually maintaining hundreds of applications.

The synchronization pipeline runs automatically.

It currently:

  1. :counterclockwise_arrows_button: retrieves the latest application definitions from the WisdomSky LinuxServer catalog;

  2. :wrench: converts them to the ZimaOS V2 format;

  3. :test_tube: performs repository regression tests;

  4. :white_check_mark: validates application definitions with IceWhale validation tooling;

  5. :building_construction: builds the final V2 Store using the official IceWhale builder;

  6. :magnifying_glass_tilted_left: verifies the generated Store structure;

  7. :package: publishes the updated Store automatically.

The synchronization also runs regularly so that changes from the upstream catalog can progressively reach the By-Roket Store.

:five: Application Images Are NOT Modified

This is an important point regarding security and trust.

The By-Roket Store does not rebuild, patch or modify the original application container images.

The store works primarily with:

  • ZimaOS manifests;

  • application metadata;

  • Docker configuration;

  • environment variables;

  • paths;

  • ports;

  • Store integration information.

The application itself continues to use the container image defined by its upstream project.

Conceptually:

LinuxServer.io / Upstream Project
        │
        │ Original Container Image
        â–Ľ
Container Registry
        │
        â–Ľ
ZimaOS Installation

The By-Roket Store sits around the integration and configuration layer:

By-Roket Store
      │
      ├── Manifest
      ├── Metadata
      ├── Ports
      ├── Volumes
      ├── Environment
      └── ZimaOS V2 integration

There is therefore:

  • :prohibited: no hidden modified image;

  • :prohibited: no proprietary replacement image;

  • :prohibited: no application binary rebuilt by the By-Roket Store.

:six: Application Updates

The application catalog is synchronized automatically with its upstream source.

When application definitions or image references are updated upstream, the synchronization pipeline can incorporate those changes into the generated ZimaOS Store.

The project therefore aims to avoid maintaining frozen application definitions manually.

However:

The By-Roket Store does not itself rebuild LinuxServer.io images.

Container-image development and publication remain the responsibility of the original upstream projects.

:seven: Official ZimaOS Validation

Applications are not simply converted and published blindly.

Before publication, the generated application definitions are validated using IceWhale tooling.

The pipeline uses:

  • :test_tube: automated regression tests;

  • :white_check_mark: the IceWhale application validation tooling;

  • :building_construction: the official ZimaOS V2 App Store builder;

  • :magnifying_glass_tilted_left: an additional verification step for the generated distribution.

The intention is to catch malformed manifests or conversion problems before they reach the public Store.

:eight: Languages

The Store infrastructure currently supports:

🇬🇧 English — en_US
🇫🇷 French  — fr_FR

Current status

English is currently the primary maintained language for most application descriptions.

French support already exists at the Store level, but application descriptions still need progressive translation and improvement.

:nine: Planned French Translation

One of the planned improvements is to make the Store increasingly accessible to French-speaking ZimaOS users.

Planned work includes:

  • :france: application descriptions;

  • :france: summaries;

  • :france: installation information where useful;

  • :france: clearer terminology;

  • :france: improved metadata.

The objective is not simply machine-translating everything once.

Translations should remain understandable and maintainable as applications evolve.

:ten: Application Screenshots & Visual Previews

Another planned improvement is better visual presentation directly inside the ZimaOS Store.

Future versions are intended to progressively include:

  • :framed_picture: application screenshots;

  • :camera_with_flash: interface previews;

  • :artist_palette: application banners where available;

  • :memo: clearer visual descriptions.

The goal is simple:

Allow users to understand what an application looks like before installing it.

For example, instead of only seeing:

Jellyfin
Media Server

the user could also see previews of the actual application interface.

:one::one: Better Application Information

Future improvements may also include:

  • clearer descriptions;

  • supported architectures;

  • useful ports;

  • required volumes;

  • application categories;

  • upstream links;

  • documentation links;

  • installation notes;

  • compatibility information.

The goal is to make application discovery easier without turning each Store page into technical documentation.

:one::two: Consistent ZimaOS Integration

Another objective is to keep application definitions consistent.

Where appropriate, the conversion process can normalize elements such as:

PUID
PGID
TZ
Volumes
Ports
Application metadata

while remaining as close as possible to upstream expectations.

The goal is:

adapt the application to ZimaOS without unnecessarily modifying how the original application works.

:one::three: Open Source & Transparency

The complete project is publicly available on GitHub.

Users can inspect:

  • application manifests;

  • conversion tools;

  • workflows;

  • validation logic;

  • Store configuration;

  • publication process.

There is no hidden build pipeline.

:one::four: Privacy

The By-Roket Store itself adds:

  • :prohibited: no telemetry;

  • :prohibited: no analytics;

  • :prohibited: no user tracking;

  • :prohibited: no mandatory account;

  • :prohibited: no remote-control component.

Installing the Store does not give the By-Roket project access to a user’s ZimaOS server.

Each individual application may of course have its own upstream functionality and privacy policy.

:one::five: Licensing

The upstream WisdomSky project is distributed under:

GNU General Public License v3.0 — GPLv3

The By-Roket Store also keeps its source code open and preserves the GPLv3 licensing model.

The intention is to respect:

  • the original project;

  • its contributors;

  • upstream licenses;

  • attribution requirements.

The Store does not claim ownership of LinuxServer.io applications or third-party software included in the catalog.

Each application remains subject to the license of its respective upstream project.

:one::six: Current Status — Version 1

The first version of the By-Roket LinuxServer Store is already functional.

Current priorities were:

  • :white_check_mark: reliable automatic synchronization;

  • :white_check_mark: ZimaOS V2 conversion;

  • :white_check_mark: official validation;

  • :white_check_mark: automatic publication;

  • :white_check_mark: open source availability;

  • :white_check_mark: repeatable builds.

This provides the foundation for the next improvements.

:one::seven: Planned Improvements

Development will continue progressively.

Planned work includes:

:framed_picture: Store presentation

  • screenshots;

  • preview images;

  • richer metadata.

:globe_showing_europe_africa: Languages

  • improved English descriptions;

  • progressive French translation.

:package: Applications

  • compatibility improvements;

  • better categories;

  • application-specific fixes when required.

:counterclockwise_arrows_button: Automation

  • synchronization improvements;

  • stronger validation;

  • compatibility monitoring.

:books: Documentation

  • clearer installation instructions;

  • troubleshooting information;

  • contribution guidance.

:one::eight: Feedback & Bug Reports

The Store is already available for testing.

If you encounter:

  • :cross_mark: an application that fails to install;

  • :bug: a manifest problem;

  • :electric_plug: an incorrect port;

  • :file_folder: an incorrect path;

  • :memo: incorrect metadata;

  • :globe_showing_europe_africa: a translation issue;

  • :light_bulb: an improvement idea;

please let me know.

Feedback from real ZimaOS installations is extremely useful.

You can report issues or suggestions through the GitHub project or the ZimaOS community.

:one::nine: Community Contribution

This Store is intended to remain a community project.

The goal is not to compete with the official ZimaOS Store.

It is to:

  • expand application availability;

  • experiment with the ZimaOS V2 Store format;

  • improve LinuxServer.io application integration;

  • identify compatibility issues;

  • contribute improvements back to the ecosystem where possible.

:two::zero: Long-Term Goal

The objective is simple:

Provide ZimaOS users with a transparent, automated and maintainable LinuxServer application catalog while preserving upstream applications and keeping the ZimaOS experience simple.

This is only the first version.

More improvements will come progressively as the Store is tested by more users.

Thank you to WisdomSky, LinuxServer.io, IceWhale/ZimaOS, and everyone who tests or contributes to the project.

— By-Roket

:france: FRANÇAIS

:rocket: By-Roket LinuxServer Store pour ZimaOS V2

Store communautaire automatisé

:waving_hand: Introduction

Bonjour à toute la communauté ZimaOS,

Je suis By-Roket, Responsable / Administrateur Systèmes et infrastructures IT, avec un intérêt particulier pour le self-hosting, les réseaux, Docker, la virtualisation et la sécurité des infrastructures.

Après avoir adopté ZimaOS, j’ai souhaité contribuer à son écosystème en améliorant l’accès à un catalogue d’applications fiable et régulièrement maintenu, tout en conservant une installation aussi simple que possible.

C’est ainsi qu’est né :

By-Roket LinuxServer Store for ZimaOS V2

Le projet est déjà :

  • :white_check_mark: disponible ;

  • :white_check_mark: fonctionnel ;

  • :white_check_mark: open source ;

  • :white_check_mark: maintenu automatiquement ;

  • :white_check_mark: compatible avec le format Store V2 de ZimaOS.

:one: Liens du projet

:link: DĂ©pĂ´t GitHub

https://github.com/By-Roket/By_Roket-ZimaOS-V2-LinuxServer-Store

:package: Adresse publique du Store ZimaOS V2

https://by-roket.github.io/By_Roket-ZimaOS-V2-LinuxServer-Store/store.json

Cette adresse peut déjà être utilisée comme source de Store personnalisé ZimaOS V2.

:two: Projet original et crédits

Ce projet n’a pas été créé à partir de zéro.

Sa base initiale provient de l’excellent travail réalisé par WisdomSky :

WisdomSky — CasaOS LinuxServer AppStore

https://github.com/WisdomSky/CasaOS-LinuxServer-AppStore

Le projet WisdomSky fournit un important catalogue de configurations d’applications basées principalement sur les images conteneurs maintenues par la communauté LinuxServer.io, adaptées à CasaOS.

Le projet By-Roket reprend cette excellente base et retravaille sa couche d’intégration afin de l’adapter au protocole Store V2 de ZimaOS.

L’objectif n’est ni de masquer ni de remplacer le travail original.

Au contraire :

WisdomSky reste clairement crédité comme catalogue upstream et base originale du projet.

Merci notamment Ă  :

  • :heart: WisdomSky pour le CasaOS LinuxServer AppStore original ;

  • :spouting_whale: LinuxServer.io pour la maintenance des images des applications ;

  • :snowflake: IceWhale / ZimaOS pour la plateforme ZimaOS, ses outils de validation et son protocole Store V2.

:three: Qu’est-ce qui a été retravaillé pour ZimaOS V2 ?

Les définitions d’applications originales de WisdomSky sont prévues pour l’écosystème Store de CasaOS.

Le projet By-Roket ajoute une couche d’adaptation automatisée destinée à ZimaOS V2.

Fonctionnement simplifié

Catalogue WisdomSky
        │
        â–Ľ
Synchronisation automatique
        │
        â–Ľ
Conversion By-Roket
        │
        â–Ľ
Manifest ZimaOS V2
        │
        â–Ľ
Validation IceWhale
        │
        â–Ľ
Builder officiel ZimaOS V2
        │
        â–Ľ
Store public By-Roket

Cela permet de rester proche du catalogue upstream tout en bénéficiant du protocole Store plus récent de ZimaOS.

:four: Synchronisation entièrement automatisée

L’un des objectifs principaux est d’éviter de devoir maintenir manuellement des centaines d’applications.

La chaîne de synchronisation fonctionne automatiquement.

Elle réalise actuellement :

  1. :counterclockwise_arrows_button: récupération des dernières définitions d’applications depuis le catalogue LinuxServer de WisdomSky ;

  2. :wrench: conversion vers le format ZimaOS V2 ;

  3. :test_tube: exécution des tests de régression du dépôt ;

  4. :white_check_mark: validation des définitions à l’aide des outils IceWhale ;

  5. :building_construction: construction du Store V2 avec le builder officiel IceWhale ;

  6. :magnifying_glass_tilted_left: vérification de la structure du Store généré ;

  7. :package: publication automatique.

La synchronisation est également exécutée régulièrement afin que les évolutions du catalogue upstream puissent progressivement être répercutées dans le Store By-Roket.

:five: Les images des applications ne sont PAS modifiées

C’est un point important concernant la sécurité et la confiance.

Le Store By-Roket ne reconstruit, ne patch et ne modifie pas les images conteneurs originales des applications.

Le projet intervient principalement sur :

  • les manifests ZimaOS ;

  • les mĂ©tadonnĂ©es ;

  • la configuration Docker ;

  • les variables d’environnement ;

  • les chemins ;

  • les ports ;

  • les informations d’intĂ©gration au Store.

L’application continue d’utiliser l’image conteneur définie par son projet upstream.

Schéma

LinuxServer.io / Projet upstream
        │
        │ Image conteneur originale
        â–Ľ
Registry Docker
        │
        â–Ľ
Installation ZimaOS

Le Store By-Roket intervient autour de cette image :

Store By-Roket
      │
      ├── Manifest
      ├── Métadonnées
      ├── Ports
      ├── Volumes
      ├── Variables
      └── Intégration ZimaOS V2

Il n’y a donc :

  • :prohibited: aucune image modifiĂ©e cachĂ©e ;

  • :prohibited: aucune image propriĂ©taire de remplacement ;

  • :prohibited: aucun binaire d’application reconstruit par le Store By-Roket.

:six: Mise Ă  jour des applications

Le catalogue est automatiquement synchronisé avec sa source upstream.

Lorsque des définitions ou références d’images sont mises à jour upstream, la chaîne de synchronisation peut intégrer ces changements dans le Store ZimaOS généré.

Cela évite autant que possible de conserver manuellement des définitions d’applications figées.

Cependant :

Le Store By-Roket ne construit pas lui-mĂŞme les images LinuxServer.io.

La création et la publication des images restent sous la responsabilité des projets upstream.

:seven: Validation officielle ZimaOS

Les applications ne sont pas simplement converties puis publiées sans contrôle.

Avant publication, les définitions générées passent par plusieurs étapes.

La chaîne utilise notamment :

  • :test_tube: des tests automatisĂ©s ;

  • :white_check_mark: les outils de validation IceWhale ;

  • :building_construction: le builder officiel du Store V2 ZimaOS ;

  • :magnifying_glass_tilted_left: une vĂ©rification complĂ©mentaire de la distribution gĂ©nĂ©rĂ©e.

Le but est de détecter les manifests invalides ou les problèmes de conversion avant leur publication dans le Store.

:eight: Langues

L’infrastructure actuelle du Store prend en charge :

🇬🇧 Anglais  — en_US
🇫🇷 Français — fr_FR

État actuel

L’anglais reste actuellement la langue principale maintenue pour la majorité des descriptions.

La prise en charge française existe déjà au niveau du Store, mais les descriptions nécessitent encore une traduction et une amélioration progressive.

:nine: Traduction française prévue

L’une des évolutions prévues est de rendre le Store de plus en plus accessible aux utilisateurs francophones de ZimaOS.

Sont notamment prévus :

  • :france: descriptions des applications ;

  • :france: rĂ©sumĂ©s ;

  • :france: informations d’installation lorsque nĂ©cessaire ;

  • :france: terminologie plus claire ;

  • :france: amĂ©lioration des mĂ©tadonnĂ©es.

Le but n’est pas simplement de traduire automatiquement une fois toutes les descriptions.

Les traductions devront rester compréhensibles et maintenables lorsque les applications évoluent.

:ten: Captures et aperçus des applications

Une autre évolution prévue concerne la présentation visuelle des applications directement dans le Store ZimaOS.

Les prochaines versions devraient progressivement intégrer :

  • :framed_picture: captures d’écran ;

  • :camera_with_flash: aperçus des interfaces ;

  • :artist_palette: bannières lorsque disponibles ;

  • :memo: prĂ©sentation visuelle amĂ©liorĂ©e.

L’objectif est simple :

Permettre à l’utilisateur de voir à quoi ressemble une application avant de l’installer.

:one::one: Informations d’application améliorées

Les prochaines Ă©volutions pourront Ă©galement apporter :

  • descriptions plus claires ;

  • architectures compatibles ;

  • ports utiles ;

  • volumes nĂ©cessaires ;

  • catĂ©gories ;

  • liens upstream ;

  • liens vers la documentation ;

  • notes d’installation ;

  • informations de compatibilitĂ©.

Le but est de faciliter la découverte des applications sans transformer chaque fiche en documentation technique interminable.

:one::two: Intégration ZimaOS cohérente

Un autre objectif est de conserver des définitions cohérentes entre les applications.

Lorsque cela est pertinent, la conversion peut harmoniser certains éléments comme :

PUID
PGID
TZ
Volumes
Ports
Métadonnées

tout en restant aussi proche que possible des attentes du projet upstream.

Le principe reste :

Adapter l’application à ZimaOS sans modifier inutilement son fonctionnement original.

:one::three: Open source et transparence

L’intégralité du projet est disponible publiquement sur GitHub.

Chacun peut consulter :

  • les manifests ;

  • les outils de conversion ;

  • les workflows ;

  • les tests ;

  • les mĂ©canismes de validation ;

  • la configuration du Store ;

  • le processus de publication.

Il n’existe pas de pipeline caché.

:one::four: Confidentialité

Le Store By-Roket n’ajoute :

  • :prohibited: aucune tĂ©lĂ©mĂ©trie ;

  • :prohibited: aucun analytics ;

  • :prohibited: aucun suivi utilisateur ;

  • :prohibited: aucun compte obligatoire ;

  • :prohibited: aucun composant de contrĂ´le distant.

Ajouter le Store ne donne pas au projet By-Roket un accès au serveur ZimaOS de l’utilisateur.

Chaque application installée peut bien entendu disposer de ses propres fonctionnalités et de sa propre politique de confidentialité upstream.

:one::five: Licence

Le projet original de WisdomSky est distribué sous :

GNU General Public License v3.0 — GPLv3

Le projet By-Roket conserve également son code source ouvert et le modèle de licence GPLv3.

L’objectif est de respecter :

  • le projet original ;

  • ses contributeurs ;

  • les licences upstream ;

  • les obligations d’attribution.

Le Store ne revendique évidemment pas la propriété des applications LinuxServer.io ou des logiciels tiers proposés dans son catalogue.

Chaque application reste soumise Ă  la licence de son projet upstream respectif.

:one::six: État actuel — Version 1

La première version du By-Roket LinuxServer Store est déjà fonctionnelle.

Les premières priorités ont été :

  • :white_check_mark: synchronisation automatique fiable ;

  • :white_check_mark: conversion vers ZimaOS V2 ;

  • :white_check_mark: validation officielle ;

  • :white_check_mark: publication automatique ;

  • :white_check_mark: code source disponible ;

  • :white_check_mark: gĂ©nĂ©ration reproductible.

Cette première base permet maintenant de travailler sur les améliorations suivantes.

:one::seven: Améliorations prévues

Le développement va continuer progressivement.

:framed_picture: Présentation du Store

  • captures d’écran ;

  • aperçus ;

  • mĂ©tadonnĂ©es enrichies.

:globe_showing_europe_africa: Langues

  • amĂ©lioration des descriptions anglaises ;

  • traduction française progressive.

:package: Applications

  • amĂ©lioration de compatibilitĂ© ;

  • catĂ©gorisation ;

  • corrections spĂ©cifiques lorsque nĂ©cessaire.

:counterclockwise_arrows_button: Automatisation

  • amĂ©lioration de la synchronisation ;

  • contrĂ´les supplĂ©mentaires ;

  • suivi de compatibilitĂ©.

:books: Documentation

  • instructions plus claires ;

  • dĂ©pannage ;

  • informations pour contribuer.

:one::eight: Retours, bugs et suggestions

Le Store est déjà disponible pour être utilisé et testé.

Si vous rencontrez :

  • :cross_mark: une application qui ne s’installe pas ;

  • :bug: un problème de manifest ;

  • :electric_plug: un mauvais port ;

  • :file_folder: un mauvais chemin ;

  • :memo: une information incorrecte ;

  • :globe_showing_europe_africa: un problème de traduction ;

  • :light_bulb: une idĂ©e d’amĂ©lioration ;

n’hésitez pas à me le signaler.

Les retours provenant d’installations ZimaOS réelles sont particulièrement utiles.

Les problèmes et suggestions peuvent être remontés via le projet GitHub ou la communauté ZimaOS.

:one::nine: Contribution à la communauté

Ce Store a vocation Ă  rester un projet communautaire.

L’objectif n’est pas de concurrencer le Store officiel ZimaOS.

Il s’agit plutôt de :

  • augmenter le choix d’applications ;

  • expĂ©rimenter avec le protocole Store V2 ;

  • amĂ©liorer l’intĂ©gration des applications LinuxServer.io ;

  • identifier les problèmes de compatibilitĂ© ;

  • contribuer Ă  l’écosystème lorsque cela est possible.

:two::zero: Objectif Ă  long terme

L’objectif peut se résumer simplement :

Fournir aux utilisateurs ZimaOS un catalogue LinuxServer transparent, automatisé et maintenable, tout en préservant les applications upstream et la simplicité d’utilisation de ZimaOS.

Il ne s’agit que de la première version.

Le Store continuera d’évoluer progressivement grâce aux tests et aux retours de la communauté.

Merci à WisdomSky, LinuxServer.io, IceWhale/ZimaOS, ainsi qu’à tous ceux qui testeront ou contribueront au projet.

— By-Roket

4 Likes