Kort gezegd: als je doel een Obsidian-kluis is, begin dan niet met het draaien van de Obsidian-desktopinterface in een browsercontainer
De setup uit 2025 combineerde LinuxServer Obsidian, Selkies, een reverse proxy en een gekoppelde kluis. Dat kan werken, maar introduceert vier afzonderlijke foutlagen voordat je überhaupt een notitie bewerkt: browserbeveiliging, WebSocket/HTTPS, volumekoppeling van de container en het Obsidian-desktopproces. In 2026 biedt ZimaSpace nu specifiek OZSync voor Obsidian voor back-ups, cloudtoegang en synchronisatie tussen apparaten, wat een betere eerste stap is wanneer het werkelijke doel is: “mijn kluis op ZimaOS houden”.
OZSync voor Obsidian staat vermeld in het plug-in-ecosysteem van ZimaOS.
Kies de architectuur voordat je de container repareert
Er zijn drie praktische modellen:
- Een normale lokale kluis synchroniseren: Obsidian draait native op je Mac/pc; een synchronisatielaag houdt de kluis op ZimaOS.
- Een kluis openen via een gekoppeld bestandssysteem: de desktopapp gebruikt een gekoppelde share, met de gebruikelijke aandachtspunten rond latentie en offlinegebruik.
- Obsidian zelf in een browsercontainer draaien: LinuxServer/Selkies streamt de GUI op afstand. Dit is de meest complexe optie.
Als je alleen voor de browsercontainer hebt gekozen omdat je dacht dat die nodig was voor ZimaOS-opslag, vereenvoudig de setup dan eerst.
Als je de container behoudt, controleer dan host- en containerpaden afzonderlijk
Wanneer een kluis “nooit verschijnt”, controleer dan de Docker-volumekoppeling in plaats van de Obsidian-interface:
# voorbeeld
/media/Notes/MyVault -> /vaults/MyVaultObsidian in de container kan alleen het pad aan de rechterkant zien. ZimaOS Bestanden toont het pad aan de linkerkant. De app-paden van ZimaOS legt deze grens uit, terwijl Docker's bind mounts het runtimegedrag definiëren.
Los HTTPS op voordat je Selkies debugt
Containers met een via de browser gestreamde desktop kunnen afhankelijk zijn van beveiligde browser-API's en WebSocket-connectiviteit. Als de app oorspronkelijk “onveilige toegang” weigerde, was reverse proxying naar HTTPS een redelijke oplossing. Test het proxy-eindpunt echter voordat je de kluismap toevoegt. Een werkende Selkies-pagina bewijst niet dat het Obsidian-proces of het bijbehorende WebSocket-pad goed werkt.
HTTPS-proxying in ZimaOS beschrijft het reverse-proxymodel van ZimaOS.
Wanneer Selkies opent, maar Obsidian niet
Als je de container opnieuw start en de streaming-shell ziet zonder de applicatie, betekent dit meestal dat de container actief is, maar dat het desktopproces is mislukt. Controleer de containerlogs, de imageversie, de eigenaarschap van de permanente configuratie en het beschikbare geheugen. Verwijder de kluis niet tijdens het oplossen van problemen met de GUI.
docker ps -a
docker logs --tail=200 YOUR_OBSIDIAN_CONTAINER
ls -ld /media/Notes/MyVaultLinuxServer publiceert momenteel Obsidian als een container die via het web toegankelijk is, maar hun images zijn nog steeds afhankelijk van correcte permanente machtigingen voor /config en hostvolumes. De Obsidian-container van LinuxServer is de upstreambron.
Houd de kluis als gewone bestanden die je zonder de container kunt herstellen
Een Obsidian-kluis is in wezen een map met Markdown-bestanden plus .obsidian-configuratie. Bewaar die map op normale ZimaOS-gegevensopslag en maak er afzonderlijk een back-up van. Als de streamingcontainer defect raakt, moeten je notities leesbaar blijven met elke teksteditor.
De ZimaOS-back-up en de appvereisten van ZimaOS behandelen herstel en capaciteitsplanning.
Een bestaande kluis importeren zonder deze opnieuw op te bouwen
Stop Obsidian, kopieer de volledige kluis — inclusief de verborgen .obsidian-instellingen als je die wilt behouden — naar de hostmap, controleer het eigenaarschap, start daarna de container en open het gekoppelde containerpad. Kopieer geen bestanden terwijl twee onafhankelijke synchronisatie-engines de kluis beschrijven, omdat conflicterende bestanden en verwijderde notities moeilijker te ontwarren zijn dan een eenvoudig koppelingsprobleem.
Gebruik synchronisatie in plaats van een browserdesktop wanneer je op meerdere apparaten bewerkt
Voor laptops en telefoons houdt een synchronisatiegerichte opzet de Obsidian-ervaring op elk apparaat lokaal en responsief. Hierdoor ben je ook minder afhankelijk van een externe browsersessie en wordt offline notities maken mogelijk. Gebruik de browsercontainerbenadering wanneer gecentraliseerde GUI-toegang specifiek is wat je wilt, niet alleen omdat de gegevens op een NAS staan.
Veelgestelde vragen
Waarom verschijnt mijn gekoppelde Obsidian-kluis niet?
De meest voorkomende oorzaak aan de containerkant is een onjuiste volumepadkoppeling. Controleer het hostpad, het containerpad en de machtigingen voordat je de Obsidian-instellingen wijzigt.
Heeft Obsidian HTTPS nodig op ZimaOS?
Native desktop-Obsidian heeft niet nodig dat de webinterface van je NAS de editor aanbiedt. Een via de browser gestreamde Selkies-container kan HTTPS of correct beveiligd WebSocketgedrag vereisen.
Moet ik de kluis op SMB opslaan?
Dat kan werken, maar een lokale kluis met synchronisatie is over het algemeen eenvoudiger offline te gebruiken en minder gevoelig voor netwerkonderbrekingen.
Kan ik een bestaande Markdown-kluis rechtstreeks kopiëren?
Ja. Een kluis is een map met bestanden. Kopieer de volledige map, inclusief .obsidian als je plug-ins en instellingen wilt behouden, en laat de gekozen Obsidian-instantie vervolgens naar dat pad verwijzen.
Wat is momenteel de eenvoudigste Obsidian-setup op ZimaOS?
Als het doel synchronisatie van de kluis tussen apparaten is, begin dan met het evalueren van de huidige OZSync-integratie in plaats van een volledige browserdesktopstack te bouwen.
