Nya Zima-dokument: Från installation av ZimaOS till appar, hårdvara, utvecklarverktyg och community

En hemmaserver förblir sällan som den var dag ett. Du börjar med att få systemet online, lägger sedan till lagring, flyttar över dina filer, installerar några appar, experimenterar med fjärråtkomst och kommer så småningom på dig själv med att jämföra RAID-nivåer, köra Jellyfin, säkerhetskopiera foton, testa lokal AI eller läsa om ZFS sent en söndagskväll.

Därför byggde vi om ZimaSpace Docs kring det som människor faktiskt försöker göra. I stället för att behandla dokumentationen som en enda lång manual ger den nya strukturen dig fem tydliga lärvägar: ZimaOS, App Store, Hardware, Developer och Help Center. Och när den dokumenterade vägen inte räcker till ger ZimaSpace Community dig ytterligare en plats där du kan jämföra konfigurationer, ställa frågor, dela lösningar och se vad andra användare bygger.

För de flesta nya användare börjar resan naturligt med ZimaOS, går vidare till appar när grunderna fungerar och förgrenar sig till hårdvara eller utvecklarverktyg när konfigurationen blir mer ambitiös. Men det finns ingen obligatorisk ordning: om du är här för Jellyfin kan du gå direkt till App Store; om du behöver ZFS eller SSH går du direkt till Developer; om något redan har slutat fungera börjar du i Help Center; och om din konfiguration inte riktigt passar in i en formell guide är Community ofta nästa ställe att leta på.

1. ZimaOS: Börja med grunden

Dokumentationen för ZimaOS är den bästa startpunkten om din huvudsakliga fråga handlar om att få operativsystemet, lagringen, data, säkerhetskopieringar och den dagliga åtkomsten att fungera korrekt.

Den här delen av dokumentationen följer en hemmaservers naturliga livscykel i stället för att behandla varje funktion som en isolerad guide: starta systemet, organisera lagringen, ta in dina data, göra dessa data tillgängliga och sedan lära dig underhålla servern.

Översikt

Översikten över ZimaOS fungerar som ingången till hela avsnittet. Om du ännu inte är säker på vilken guide du behöver kan du börja här. Den knyter samman konfiguration, lagring, säkerhetskopiering, fildelning, installation och systemhantering, så att du snabbt kan gå vidare till det problem du faktiskt försöker lösa.

För ett helt nytt system är guiden Kom igång med ZimaOS den rakaste vägen. Den går igenom den första anslutningen, ZimaClient, skapandet av ett konto och den grundläggande miljö som du kommer att använda därefter.

Konfiguration och lagring

Om servern är ny kan du ägna lite tid åt detta innan du installerar tio appar bara för att de verkar intressanta.

Konfiguration och lagring omfattar beslut som blir svårare att ändra senare: att förstå ZimaOS-gränssnittet, välja enheter, skapa lagring, jämföra RAID-alternativ och bestämma var programdata ska lagras.

Guiden för lagringskonfiguration i ZimaOS är särskilt användbar om du väljer mellan ett enkelt system med en enda disk, redundant lagring för viktiga filer, ett större mediebibliotek eller lagring för en hemmaserver som alltid är på.

Om du får lagringsstrukturen rätt från början blir nästan allt som följer enklare.

Synkronisering och säkerhetskopiering

När servern väl är igång handlar nästa fråga vanligtvis inte om själva servern. Den handlar om dina data: hur får jag egentligen över allt mitt innehåll till den?

Synkronisering och säkerhetskopiering samlar dessa migreringsvägar. Den här delen av dokumentationen omfattar säkerhetskopiering av telefoner, säkerhetskopiering av datorer, anslutningar till molnlagring, flytt av data från en annan NAS, överföring av filer mellan enheter, Time Machine och mer övergripande arbetsflöden för säkerhetskopiering.

Foton är ofta en av de första stora personliga datamängderna som människor flyttar till en hemmaserver. Om du vill bygga ett privat fotobibliotek ger guiden för säkerhetskopiering av foton med Immich dig en praktisk väg till säkerhetskopiering och hantering av foton på ZimaOS.

Oavsett om du flyttar några hundra mobilbilder eller gradvis ersätter ett äldre NAS- eller molnlagringsarbetsflöde behöver du inte migrera allt under en enda helg. Flytta en källa i taget och bygg säkerhetskopieringssystemet kring den data du faktiskt bryr dig om.

Åtkomst och delning

En NAS som bara kan nås när du sitter bredvid den är inte särskilt spännande.

Åtkomst och delning är där ZimaOS börjar ansluta servern till resten av dina enheter. Avsnittet täcker ZimaClient, fjärråtkomst, SMB-fildelning, delningslänkar och Samba-konfigurationer för flera användare.

Om du ansluter en dator eller telefon för första gången är installationsguiden för ZimaClient en bra utgångspunkt.

Därifrån kan du välja åtkomst utifrån situationen: lokal fildelning för datorer i hemmet, fjärråtkomst när du är hemifrån eller delningsverktyg när någon annan bara behöver vissa filer eller mappar.

Installationsmetoder

ZimaOS är inte begränsat till en enda installationsmetod.

Om du installerar systemet själv går guiden Så installerar du ZimaOS igenom hur du skapar installationsmedia, startar enheten, installerar operativsystemet och får åtkomst till systemet efteråt.

Det här avsnittet är särskilt användbart för personer som bygger egna hemmaservrar med kompatibel x86-64-hårdvara, samt för användare som experimenterar med Proxmox, migrerar från CasaOS eller hanterar andra installations- och kontorelaterade uppgifter.

System

Du kommer förmodligen inte att öppna avsnittet System varje dag. Det är bra.

När en server blir en del av ditt dagliga arbetsflöde är tillförlitlighet viktigare än installationen. Avsnittet System täcker den mindre glamorösa men viktiga sidan av att köra ZimaOS, inklusive strömskydd, återställning, offlineinstallation, nätverksåterställningar, sökning och andra underhållsuppgifter.

Det här är inte nödvändigtvis de första guiderna du läser, men du kan vara glad att känna till dem innan du faktiskt behöver dem.

2. Appbutik: Bestäm vad du vill att din server ska göra

Det är tillfredsställande att få lagringen online. Att installera den första användbara appen är vanligtvis när en hemmaserver börjar kännas som din hemmaserver.

Dokumentationen för ZimaOS App Store är organiserad efter arbetsbelastningar snarare än installationsmekanik.

I stället för att börja med frågan ”Hur konfigurerar jag Docker?” börjar den här delen av lärandekartan någonstans mer användbart: Vad vill du att din server ska göra?

Medieserver

Det här är en av de enklaste platserna att börja med självhosting. En hemserver kan bli ett privat bibliotek för filmer, tv, musik, foton och andra medier som förblir under din kontroll.

Avsnittet Medieserver samlar Jellyfin, Plex, Emby, Immich, DLNA-tjänster, kameraservrar, fotomigrering och mediearbetsbelastningar med GPU-stöd.

Om Jellyfin är ditt första serverprojekt ger guiden för att konfigurera en Jellyfin-medieserver dig en direkt väg till att skapa ett privat streamingbibliotek.

Om din första idé om en hemserver låter mer som ”Jag vill ha mitt eget Netflix” eller ”Jag vill ha bort mina foton från ett molnabonnemang”, är det här den del av dokumentationen du bör utforska först.

Självhostade appar

Efter medieservern kommer den farliga delen: insikten att du kan självhosta nästan allt.

Det här avsnittet omfattar verktyg för filsynkronisering, annonsblockering i hela nätverket, dokumenthantering, automatisering av nedladdningar, övervakning, mediehantering och andra tjänster som normalt skulle finnas någonstans i molnet.

Du behöver inte ha tjugo containrar redan första dagen. Välj ett problem som du vill att servern ska lösa, få det arbetsflödet att fungera och lägg sedan till nästa tjänst.

AI & Machine Learning

Lokal AI har snabbt blivit ännu en anledning att ha en kapabel server igång hemma.

Avsnittet AI & Machine Learning fokuserar på arbetsbelastningar där modeller, dokument, foton eller agenter kan köras nära dina egna data. Lärandep vägen omfattar distribution av lokala modeller, AI-baserad sökning, offline-modeller, fotoanalys och AI-agenter som alltid är aktiva.

Om du är intresserad av privat AI, lokala LLM-modeller eller agenter som behöver kontinuerlig åtkomst till filer som lagras på din server, är det här grenen du ska följa.

Creative Builds

Alla hemserverprojekt behöver inte förbättra produktiviteten. Ibland vill du helt enkelt bygga något för att du kan.

Creative Builds samlar mer experimentella projekt, som spelservrar, retrospel, VR-relaterade konfigurationer, virtualiseringsexperiment, appbutiker för communities och andra projekt som befinner sig någonstans mellan ett homelab och en helghobby.

För homelab-användare är det ofta här ett projekt i tysthet blir till ytterligare tre.

Utvecklarresurser

Förr eller senare stöter vissa användare på samma problem: appen de vill ha finns ännu inte i butiken.

Utvecklarresurser är nästa steg för personer som själva vill bygga och publicera appar, och skapar en naturlig brygga från att använda App Store till att bidra till ekosystemet bakom den.

3. Maskinvara: Förstå maskinen bakom programvaran

Programvaruguiderna besvarar många frågor tills frågan blir ”Vilken port är det?” eller ”Kan den här maskinen ta ytterligare en enhet, ett nätverkskort, en GPU eller ett operativsystem?”

Det är där maskinvarudokumentationen tar vid.

Översikt

Maskinvaruöversikten samlar de viktigaste Zima-enhetsfamiljerna och ger dig ett snabbt sätt att förstå vilken dokumentationsväg som passar den maskinvara du har framför dig.

ZimaCube är byggd för större NAS-, lagrings-, medie- och expansionsfokuserade arbetsbelastningar. ZimaBoard passar för kompakt hemserver, nätverk, självhosting och maskinvaruexperiment. ZimaBlade erbjuder en mindre ingång till DIY-NAS- och serverprojekt.

När du vet vilken familj du arbetar med blir resten av maskinvaruavsnittet mycket enklare att navigera i.

ZimaCube

ZimaCube-vägen är till för användare som arbetar med ett större NAS- och expansionsfokuserat system.

Guiderna går vidare från den första konfigurationen till maskinvarugränssnitt, extra lagring, GPU-expansion, SSD-expansion, BIOS-konfiguration, nätverk, Thunderbolt, kylning, Wake-on-LAN och andra enhetsspecifika funktioner.

Använd det här avsnittet när frågan inte längre bara är ”Hur använder jag ZimaOS?” utan ”Vad kan just den här maskinvarukonfigurationen göra?”

ZimaBoard 2

ZimaBoard 2 är den kompakta och expansionsvänliga delen av maskinvarukartan. Det är utformat för användare som gillar att experimentera med hemservrar, nätverk, självhosting, lagring och anpassade maskinvarukonfigurationer.

Om du precis har tagit ut kortet ur förpackningen börjar du med kom igång-guiden för ZimaBoard 2. Den ger maskinvaruinstallationen en tydlig startpunkt innan du går vidare till lagring, nätverk, appar, kylning eller PCIe-expansion.

Därefter täcker ZimaBoard-dokumentationen maskinvarugränssnitt, steg för att starta enheten, expansion, kylning, konfigurering av PWM-fläktar och praktiska detaljer för att integrera kortet i ett större homelab-projekt.

Det gör samma kort lämpligt för många olika användningsområden: en kompakt NAS, en medieserver, en Docker-värd, en nätverksenhet, en virtualiseringsnod eller någon annan självhostad tjänst som alltid är igång.

ZimaBlade

ZimaBlade håller hårdvaruvägen enklare och erbjuder en lättillgänglig ingång till gör-det-själv-servrar.

Dokumentationen fokuserar främst på att få igång hårdvaran, förstå den grundläggande konfigurationen och förbereda systemet innan du börjar lägga applikationer och tjänster ovanpå det.

Kompatibilitet

Hemservrar existerar sällan ensamma. Enheter, UPS-enheter, nätverksadaptrar, Wi-Fi-moduler, expansionskort och andra tillbehör blir gradvis en del av systemet.

Kompatibilitetsavsnittet besvarar den praktiska frågan om vad som har testats och hur specifik hårdvara bör konfigureras.

Det har en mycket enkel uppgift: att hjälpa dig besvara frågan ”Fungerar detta med min konfiguration?” innan du tillbringar en eftermiddag med att undra varför det inte gör det.

Tredjepartssystem

Zima-hårdvara är inte låst till ett enda operativsystem.

Om ditt projekt kräver Unraid, TrueNAS, OpenWrt, OpenMediaVault, Ubuntu Server, Arch Linux eller någon annan miljö ger avsnittet Tredjepartssystem en väg till alternativa distributioner.

Det innebär att hårdvarudokumentationen förblir användbar även när ditt projekt så småningom växer bortom själva ZimaOS.

4. Utvecklare: Gå djupare när standardinställningarna inte längre räcker

De flesta behöver inte börja här—och det är precis poängen.

Utvecklardokumentationen är till för det ögonblick då bekväma standardinställningar inte längre räcker och du vill ha mer kontroll över systemet under dem.

Översikt

Utvecklaröversikten är den avancerade grenen av inlärningskartan för avancerade användare, hemlabbsbyggare, utvecklare och alla som vill gå djupare än ZimaOS standardgränssnitt.

Om du redan vet vad du letar efter—ZFS, SSH, API:er, anpassade appar eller mer avancerade nätverk—behöver du inte gå igenom nybörjarguiderna först. Börja här.

Lagring och filsystem

Det här avsnittet går bortom den vardagliga diskkonfigurationen och tar upp teknik som ZFS, avancerade RAID-konfigurationer, NFS, iSCSI, krypterad lagring, rsync, återställningsarbetsflöden och anslutningar till andra NAS-system.

Om Installation och lagring i ZimaOS-avsnittet besvarar frågan ”Hur bör jag konfigurera mina enheter?”, börjar avsnittet Utvecklarlagring besvara en annan fråga: ”Hur fungerar lagringsstacken och hur mycket kontroll kan jag ha över den?”

Nätverk och protokoll

När ett hemlabb växer blir nätverk en del av projektet i stället för något som bara händer i bakgrunden.

Nätverk och protokoll omfattar nätverkskonfiguration, SSH-åtkomst, avancerade SSH-inställningar, överföringsprestanda och de protokoll som används för att ansluta ZimaOS till andra maskiner.

Det här är nästa naturliga steg när du börjar arbeta med flera servrar, snabbare nätverk, fjärrskal eller mer avancerade nätverkskonfigurationer.

Utveckling

Den här grenen är till för att bygga ovanpå själva systemet.

För användare som vill automatisera sin server eller bidra till ekosystemet omfattar utvecklingsavsnittet skriptmiljöer, arbetsflöden för bidrag och communitydriven utveckling.

Även om du inte bygger en komplett applikation kan ett litet skript bli förvånansvärt användbart när det besparar dig från att upprepa samma administrativa uppgift varje vecka.

App Store-utveckling

Att köra appar och att bygga appar är två olika steg på samma resa.

App Store-utveckling är utformat för dig som vill paketera Docker-applikationer, publicera dem för ZimaOS-användare, bygga appkataloger, arbeta med Docker Compose-metadata, hantera tillgångar och lokalisering eller automatisera arbetsflöden för apppublicering.

Om App Store-avsnittet är lekplatsen, är detta verkstaden bakom den.

ZimaOS API

När det inte längre räcker att klicka på knappar manuellt blir API:et nästa lager.

Avsnittet ZimaOS API ger tillgång till programstyrning, autentisering, integrationer, tillgängliga slutpunkter och verktyg för att utforska hur andra program kan kommunicera med ZimaOS.

Det öppnar dörren till anpassade skript, instrumentpaneler, hanteringsverktyg och integrationer som är byggda kring din egen hemservermiljö.

Versionslogg

Utvecklarområdet håller också ZimaOS versionshistorik nära den tekniska dokumentationen.

Det blir användbart när beteendet förändras mellan versioner, när du vill förstå när en funktion introducerades eller när en guide bygger på funktionalitet som infördes i en nyare version av ZimaOS.

5. Hjälpcenter: Börja med symtomet

Ibland vill du inte lära dig ett nytt lagringsprotokoll. Du vill bara att maskinen ska starta igen.

ZimaSpace hjälpcenter är medvetet den kortaste vägen på kartan. I stället för att kräva att du först förstår grundorsaken låter det dig börja med problemet du faktiskt kan se.

Översikt

Om du har hamnat här är det stor chans att något redan inte fungerar som du förväntade dig.

Hjälpcentret vägleder användarna till felsökning och referensmaterial, i stället för att tvinga dem att söka igenom varje installationsguide för att avgöra om problemet gäller programvara, lagring, nätverk eller hårdvara.

Felsökning

Om enheten inte startar, RAID-skapandet misslyckas, en nätverksanslutning försvinner, minnet behöver testas, BIOS behöver åtgärdas eller en hårdvaruanslutning inte fungerar, börjar du här.

Felsökningsvägen är utformad för att minska avståndet mellan:

”Något är fel” → ”Det här verkar vara mitt problem” → ”Det här ska jag kontrollera.”

Det är vanligtvis mer användbart än att förvänta sig att någon ska veta om ett problem hör till operativsystemet, lagringslagret, nätverksstacken eller hårdvaran innan de börjar leta efter hjälp.

Referens

Alla användbara sidor behöver inte vara steg-för-steg-guider.

Referensområdet innehåller stödjande information och tekniskt material som användare ibland behöver slå upp utan att följa en komplett handledning.

Community: När Docs bara är början

Dokumentation fungerar bäst när problemet redan har ett tydligt svar. Hemservrar är inte alltid så samarbetsvilliga.

Din konfiguration kanske kombinerar ett nätverkskort, en lagringsstyrenhet, en Docker-stack och en operativsystemversion som ingen enskild guide har skrivits för. Kanske vill du veta hur en annan användare löste samma lagringsproblem i Immich. Eller så har du byggt något användbart som andra borde få veta mer om.

Det är där ZimaSpace Community blir nästa lager i lärandekartan.

Communityn samlar flera typer av kunskap som är svåra att fånga i statisk dokumentation:

• Felsökning i verkligheten: se hur andra användare diagnostiserar ovanliga problem med ZimaOS, appar, lagring, nätverk och hårdvara.
• Communityhandledningar: upptäck arbetsflöden och konfigurationer som skapats av personer som kör ZimaOS i sina egna miljöer.
• Hårdvaruexperiment: jämför expansionskort, nätverkskonfigurationer, lagringskonfigurationer, virtualiseringsprojekt och andra homelab-byggen.
• Feedback och idéer: föreslå funktioner, rapportera problem och diskutera hur ZimaOS och Zima-hårdvara kan förbättras.
• Utannonseringar: följ ZimaOS-versioner, produktuppdateringar, communityprojekt och andra förändringar i ekosystemet.

En enkel tumregel är: använd Docs när du behöver den etablerade vägen; använd Community när du vill se hur andra faktiskt tar sig fram.

Om du inte hittar svaret direkt kan du gå tillbaka till startsidan för ZimaSpace Docs eller fortsätta samtalet i ZimaSpace Community.

FAQ: Hitta rätt bland de nya ZimaSpace-dokumenten

Var bör en ny ZimaOS-användare börja?

Börja med guiden Kom igång med ZimaOS. Därifrån går den naturliga vägen vanligtvis vidare genom Konfiguration och lagring, Synkronisering och säkerhetskopiering samt Åtkomst och delning, innan du börjar lägga till fler appar.

Måste jag läsa alla fem dokumentationsavsnitt i ordning?

Nej. Dokumentationen fungerar bättre som en karta än som en bok. En ny användare kan börja med ZimaOS, medan en erfaren hem-labb-användare som letar efter ZFS eller SSH kan gå direkt till utvecklardokumentationen. Om något redan är trasigt kan du börja i hjälpcentret.

Var hittar jag guider om lagring och RAID i ZimaOS?

För vanlig planering av lagring kan du börja med guiden för lagringskonfiguration i ZimaOS. För mer avancerade ämnen som ZFS, avancerad RAID, NFS eller iSCSI kan du fortsätta till Developer → Lagring och filsystem.

Var hittar jag Jellyfin, Plex, Immich eller andra självhostade appar?

Börja med dokumentationen för App Store. Medieserver omfattar tjänster som Jellyfin, Plex, Emby, Immich, DLNA och relaterade mediearbetsflöden, medan Självhostade appar omfattar ett bredare utbud av tjänster.

Var hittar jag guiderna för lokal AI?

Öppna dokumentationen för App Store och följ avsnittet AI och maskininlärning. Där samlas lokala modeller, AI-sökning, bildintelligens, offlinebaserade AI-arbetsflöden och agentprojekt.

Var bör jag börja med ZimaBoard 2?

Börja med komma igång-guiden för ZimaBoard 2. Därifrån kan du gå vidare till lagring, nätverk, expansion, kylning, ZimaOS eller system från tredje part, beroende på vad du vill bygga.

Kan jag installera ZimaOS på min egen x86-hårdvara?

Ja. Guiden Så installerar du ZimaOS beskriver installationsvägen för kompatibel x86-64-hårdvara, vilket gör den användbar för DIY-NAS- och hemmaserverprojekt samt Zima-hårdvara.

Kan jag installera ett annat operativsystem på Zima-hårdvara?

Ja. Hårdvarudokumentationen innehåller ett avsnitt om tredjepartssystem för användare som experimenterar med alternativa NAS-, Linux- eller nätverksoperativsystem.

Var hittar jag dokumentation om API, SSH, ZFS eller avancerade nätverk?

Gå direkt till utvecklardokumentationen. Det är den avancerade grenen för lagring, nätverk, utveckling, utveckling av appar till App Store och ZimaOS API.

När ska jag använda ZimaSpace Community i stället för dokumentationen?

Använd dokumentationen när du behöver en etablerad väg för installation, konfiguration eller felsökning. Använd ZimaSpace Community när din installation är ovanlig, när du vill jämföra erfarenheter från verkligheten, behöver hjälp från andra användare, vill dela din egen lösning eller har feedback som kan bidra till att förbättra ekosystemet.

Vad ska jag göra om jag inte vet vilket avsnitt som innehåller mitt problem?

Om något har slutat fungera börjar du i hjälpcentret och letar efter det symtom som stämmer överens med ditt problem. Om du försöker bygga eller konfigurera något nytt går du tillbaka till startsidan för ZimaSpace-dokumentationen och väljer den väg som ligger närmast ditt mål. Om din situation ligger utanför den dokumenterade vägen kan du ställa frågan i ZimaSpace Community.

En hemmaserver har egentligen ingen slutnivå. Det finns alltid ytterligare en disk att lägga till, ännu en app att prova, en säkerhetskopia att förbättra eller något annat märkligt helgprojekt som väntar på att bli verklighet.

Den nya dokumentationen är utformad för just den typen av resa. Börja där du befinner dig, följ den gren som motsvarar det du bygger och gå så djupt som ditt projekt kräver. Och när den dokumenterade vägen tar slut finns det förmodligen någon i communityn som redan har försökt gå lite längre.

Utforska den nya ZimaSpace-dokumentationen →

Har du en fråga, en lösning eller ett bygge värt att dela? Gå med i ZimaSpace Community →