Voorkom dat Immich-configuratie verloren gaat tijdens upgrades door het Compose-bestand, de omgevingswaarden, database, uploadbibliotheek en mountdefinities van externe bibliotheken te behandelen als afzonderlijke persistente onderdelen die samen moeten worden vastgelegd en hersteld.
Een container is vervangbaar; de configuratie eromheen niet. Een upgrade kan lijken alsof Immich is gewist wanneer een relatief bind mount-pad vanuit een andere projectmap wordt opgelost, een omgevingswijziging de opnieuw aangemaakte container nooit bereikt of de nieuwe stack met een lege database start. Breng eerst de actieve implementatie in kaart, bewaar versiebeheerste kopieรซn buiten de host en test een gecontroleerde herimplementatie vรณรณr de productiewissel.
Leg de actieve implementatie vast vรณรณr elke upgrade
Exporteer de effectieve Compose-configuratie met geredigeerde geheimen, noteer afbeeldingsversies of digests en kopieer de Compose- en omgevingsbestanden naar versiebeheer. Controleer de actieve mounts in plaats van aan te nemen dat het bestand in je editor de huidige containers heeft gestart. Geslaagd betekent dat elk runtimepad overeenkomt met een bekende hostlocatie.
Leg de paden van externe bibliotheken, reverse-proxy-instellingen, het machinelearning-URL, databaseverbindingswaarden, gebruikers- en groepsidentiteit, netwerk namen en eventuele apparaten voor hardwareversnelling vast. Een ontbrekend item leidt later tot een onverklaarbaar verschil na de upgrade.
Vragen vanuit de community over upgrades laten herhaaldelijk zien dat beheerders uit het oog verliezen welke Compose-generatie of omgevingsindeling van toepassing is. De nuttige les uit een discussie over de upgradeconfiguratie is om de huidige werkende definitie te bewaren voordat je die omzet.
Maak afzonderlijke back-ups van de database, media en implementatiebestanden
Maak een native databaseback-up plus een back-up of momentopname van het bestandssysteem van de uploadbibliotheek en implementatiemap. Noteer de start- en eindtijden, archiefgroottes en controlesommen. Met alleen een back-up van de Compose-YAML-bestanden kun je containers opnieuw opbouwen, maar geen accounts, metadata, albums of assetgegevens herstellen.
Gebruik een back-up terwijl de service is gestopt voor de eenvoudigste consistentiegrens, of coรถrdineer een live database-export en opslagmomentopname zodat hun onderlinge relatie is vastgelegd. Houd externe bibliotheken in de inventaris, ook als Immich de originelen niet beheert, omdat paden en toegangsregels nog steeds invloed hebben op de herstelde service.
Een door de community onderhouden procedure voor een upgrade naar een hoofdversie benadrukt het behoud van de database, media, Compose-configuratie en omgevingsinstellingen. Beschouw de volgorde als praktijkervaring van operators en controleer elke stap aan de hand van de release die je daadwerkelijk implementeert.
Bereid de upgrade voor met vastgepinde versies
Lees de releaseopmerkingen voor elke overgeslagen versie en werk de opgeslagen implementatiedefinitie bewust bij. Leg de doelrelease vast, haal deze op zonder oude images te verwijderen en valideer de gerenderde Compose-configuratie. Onbekende variabelen, lege koppelingen of gemengde serviceversies zijn reden om de testfase niet goed te keuren.
Als de capaciteit het toelaat, herstel de back-up naar een geรฏsoleerde teststack met andere poorten en zonder schrijftoegang tot productie. Start deze met de doelversie en controleer migraties, gebruikers, opslagpaden en achtergrondtaken. Dat een container succesvol start, bewijst op zichzelf niet dat de oorspronkelijke bibliotheek is gekoppeld.
De gerelateerde ZimaSpace-handleiding voor een beveiligde zelfgehoste NAS helpt bij het opslaan van implementatiebestanden en back-ups buiten de grens van รฉรฉn host en รฉรฉn set inloggegevens, die door een upgrade kan worden verstoord.
Aantonen dat configuratie behouden blijft na opnieuw aanmaken
Maak vรณรณr de omschakeling de testcontainers opnieuw aan vanuit de opgeslagen bestanden in plaats van ze ter plekke te herstarten. Controleer gebruikers, serverinstellingen, opslagsjablonen, bibliotheken, taken, proxietoegang en effectieve omgevingswaarden. De test is geslaagd als de configuratie behouden blijft na vervanging, omdat deze in gedocumenteerde persistente onderdelen is opgeslagen.
Upload na de productiewissel รฉรฉn testbestand, voer een zoekopdracht uit, open een origineel en maak een nieuwe databaseback-up. Herstart de stack en de host en herhaal de tests. Bewaar de oude versie, back-up en implementatiedefinitie totdat de normale werklast gedurende de observatieperiode stabiel blijft.
Als de upgrade al leeg is gestart, stop deze dan voordat onboarding of nieuwe uploads een conflicterende status creรซren. Koppel alleen een geverifieerd persistent pad opnieuw aan of herstel naar een schoon doel. Draai terug als verwachte gebruikers of bestanden ontbreken; escaleer met opgeschoonde effectieve Compose-configuratie, koppelingen, versies en back-uptijdstempels als de identiteit onduidelijk blijft.
Ondersteuning en tips
Meer om te lezen

Zo houd je pornofilms op je NAS verborgen voor gezinsleden
Houd video's voor volwassenen privรฉ op een NAS voor het hele gezin. Controleer mapmachtigingen, toegang tot Plex- en Jellyfin-bibliotheken, miniaturen, kijkgeschiedenis, gedeelde tv-aanmeldingen en...

Wat je moet controleren voordat je een communitymodel in Transformers laadt
Gebruik de Transformers Jinja-sandboxupdate om de herkomst van modellen, chatsjablonen, externe code, geserialiseerde gewichten en geรฏsoleerde eerste uitvoeringen te controleren.

Voer Mirage lokaal uit: OCR en objectdetectie vanuit รฉรฉn afbeelding
Probeer het kleine lokale visiemodel van Cactus Compute, test OCR en objectextractie met echte invoer en krijg inzicht in de beperkingen op het gebied...



