If you like getting under the hood, this section is for you. Storage systems, networking, the ZimaOS API — everything a power user or developer needs.
Storage and Filesystem
ZimaOS supports ZFS, RAID, NFS, and iSCSI out of the box. I have spent a lot of time with these systems — here is where I would start.
- ZFS Setup — create and manage ZFS pools on ZimaOS
- RAID Options Overview — compare RAID levels and pick the right one for your use case
- Create RAID 6 — dual-parity RAID step by step
- RAID Rebuild — recover your RAID after reinstalling the OS
- NFS File Sharing — share files over NFS for Linux and macOS clients
- iSCSI Usage Guide — set up block-level storage with iSCSI
- iSCSI Setup — detailed configuration walkthrough
- Rsync Backup Clones — clone entire drives or datasets with rsync
- Synology SMB Connect — connect ZimaOS to an existing Synology over SMB
- QTS Two-Way Sync — keep folders in sync between ZimaOS and QNAP
- Encrypted Folders — encrypt sensitive data at the filesystem level
Networking and Protocols
Getting your network right makes everything else faster and more reliable.
- Network Configuration — interfaces, routing, and static IPs
- Enable SSH — turn on SSH and configure basic access
- SSH Advanced Setup — key-based auth, port changes, security hardening
- Network Transfer Speed — find and fix bottlenecks
Development
Build on top of ZimaOS — whether that means a Docker app, a Python script, or a contribution to the OS itself.
- Python Environment — get Python running for scripting and automation
- Contribution Guide — contribute code, docs, or feedback to ZimaOS
- Community Contributions — drivers and improvements submitted by users
App Store Development
Build Docker and self-hosted apps for a ZimaOS home server, maintain a homelab app catalog, or publish a compatible store for another NAS OS environment.
- Build and Publish Apps — prepare an individual app for the store
- Create an App Store — build a v2-compatible store from source files
- Docker Compose and x-casaos — reference every runtime and metadata field
- App Store CI/CD — automate validation, artifacts, and static hosting
- Migrate v1 to v2 — preserve compatibility while adopting static output
- Developer FAQ — IDs, localization, hosting, builds, and compatibility
ZimaOS API
The API lets you automate file operations, user management, and system settings from your own code.
- ZimaOS API Guide — authentication, endpoints, and integration examples
- ZimaOS API Explorer — try API calls live in your browser
Version Log
Release notes for every ZimaOS version are in the sidebar — v1.2.2 through the latest.
Next
Start with what you need. The rest will be here when you are ready for it.
- Set up ZimaOS: ZimaOS Overview — installation, storage, and system settings
- Run apps: App Store Overview — media servers, self-hosted apps, and AI agents