Communityoplossing

Meerdere versies van dezelfde ZimaOS-app: welke bron moet je kiezen?

A user noticed multiple Immich entries in the ZimaOS App Store from the developer, BigBear and other sources and asked which version should be installed.

Als je dezelfde applicatienaam meer dan één keer in de ZimaOS App Store ziet, betekent dat niet per se dat de vermeldingen identiek zijn. Het antwoord van de community wees terecht op de maintainer, Docker-image, imagetag, standaardconfiguratie en updatefrequentie als de belangrijkste verschillen.

Screenshot van de ZimaOS App Store met meerdere Immich-vermeldingen van verschillende maintainers
Originele community-screenshot die laat zien waarom gebruikers meerdere vermeldingen voor dezelfde upstream-applicatie kunnen zien.

Begin bij de maintainer, niet bij het pictogram

Als er een optie bestaat die door de upstreamontwikkelaar of het ontwikkelteam wordt onderhouden, is dat vaak het eenvoudigste uitgangspunt, omdat de verpakking het dichtst bij het project zelf staat. Een communitytemplate kan nog steeds een betere keuze zijn wanneer deze ZimaOS-vriendelijke standaardinstellingen, extra services of een configuratie biedt die succesvoller op het platform is getest.

De vereisten van de ZimaOS App Store leggen uit waarom de vereisten van een applicatie betrekking hebben op de volledige stack en niet alleen op de appkaart, terwijl de eerste Docker-app het onderliggende Dockermodel beschrijft waar al deze templates uiteindelijk van afhankelijk zijn.

Vergelijk de image en tag

De tagregels voor Docker-images van Docker leggen uit dat een imagereferentie een register, namespace, repository en optionele tag bevat. Twee App Store-kaarten met dezelfde weergegeven naam kunnen daarom verschillende repositories of verschillende versies implementeren.

Voor Immich gebruikt de huidige Docker Compose-configuratie van Immich een gedefinieerde IMMICH_VERSION en meerdere services. Dat herinnert eraan dat je de volledige applicatiestack moet vergelijken, en niet alleen de naam van de hoofdimage.

Wanneer een communitytemplate de betere keuze kan zijn

Een communitypakket kan het beheer van paden, databases, netwerken of aanvullende services eenvoudiger maken. Het nadeel is dat de timing van updates en de standaardinstellingen worden bepaald door de maintainer van die template en niet rechtstreeks door het upstreamproject.

De migratie van Immich-opslag is een concreet voorbeeld: verschillende Immich-templates en volume-indelingen leidden tot zeer uiteenlopende resultaten toen gebruikers persistente gegevens naar een andere schijf verplaatsten.

Een praktische checklist voor je keuze

  1. Controleer de vermelde bron of maintainer.
  2. Vergelijk de Docker-repository en tag.
  3. Bekijk de vereiste aanvullende services, zoals PostgreSQL, Redis of MariaDB.
  4. Vergelijk de volumetoewijzingen op de host en in de container.
  5. Controleer of het pakket een duidelijk updatepad heeft.
  6. Maak een back-up van applicatiegegevens voordat je tussen templates wisselt.

Kort samengevat

Kies het pakket van de ontwikkelaar of een pakket dat nauw bij upstream aansluit wanneer je de meest standaard indeling van de applicatie wilt. Kies een betrouwbaar communitypakket wanneer de ZimaOS-specifieke standaardinstellingen een echt implementatieprobleem oplossen. Kies niet alleen op basis van het pictogram of de appnaam; vergelijk de daadwerkelijke image, versie, services, opslagtoewijzingen en maintainer.