Large image, PDF and attachment libraries increase persistent storage and backup requirements.
Research, documentation and archival knowledge bases.متطلبات أجهزة ملاحظات SiYuan: ذاكرة الوصول العشوائي، وحدة المعالجة المركزية، التخزين وDocker
خطّط للاستضافة الذاتية لـ SiYuan Note من حيث ذاكرة RAM ووحدة المعالجة المركزية ومساحة تخزين مساحة العمل وأذونات Docker والوصول عن بُعد، مع توصيات عملية للتثبيت المخصّص على ZimaOS.
SiYuan Note requirements at a glance
SiYuan provides an official Docker image and detailed workspace/permission guidance but does not publish a numerical server hardware table. The container runs the SiYuan kernel and serves the web UI on port 6806, with the workspace mounted persistently.
- RAM
- No numerical official Docker-server minimum published. Workspace size, indexing, plugins and co-hosted services determine practical memory needs.
- CPU
- No numerical official core minimum published. The SiYuan kernel and indexing/search workload are modest for a personal knowledge base.
- Storage
- No numerical official minimum. The persistent workspace contains notes, assets, configuration and local data, so capacity should follow the knowledge base and attachment library.
- Docker
- Official image: b3log/siyuan. The standard server port is 6806 and the workspace is mounted to a persistent host path.
- GPU
- No GPU is required for normal note editing, search, backlinks and knowledge-base use.
- Best Zima starting point
- ZimaBoard 2 832 is ample for a personal or small-team SiYuan workspace; choose more storage or RAM when attachments and other ZimaOS apps grow.
From official requirements to the right setup
Size SiYuan around the persistent workspace and the wider host rather than inventing a fixed server minimum.
-
Official requirements
Use the official b3log/siyuan image and persist a dedicated workspace directory. Upstream does not publish numerical CPU/RAM minimums for the Docker server.
-
Confirm your needs
Estimate workspace size, attachments and indexing/search usage. Notes themselves are small, but images, PDFs and other assets can drive storage growth.
-
Leave room to grow
Set PUID/PGID so the container can read and write the mounted workspace correctly, and configure a non-default access authentication code before remote exposure.
-
Run it on ZimaOS
On ZimaOS, use Install Custom App, map port 6806, persist /siyuan/workspace, add HTTPS/WebSocket proxying for remote access, and monitor workspace backups.
Check every playback client
- Workspace size
- Attachment/media volume
- PUID/PGID permissions
- Access authentication code
- Port 6806 exposure
- WebSocket reverse proxy
- Workspace backup strategy
- Other ZimaOS apps
Official minimum requirements
SiYuan's official repository documents its Docker image, workspace mount and server configuration but does not provide a numerical hardware minimum.
Do not invent a 2 GB or 4 GB official minimum for SiYuan. A personal knowledge base is lightweight, but storage and memory should scale with workspace assets, indexing and the rest of the ZimaOS host.
| Requirement | Official minimum | What this supports |
|---|---|---|
| RAM minimum | No numerical official minimum published | Upstream Docker documentation does not provide a RAM floor. |
| CPU minimum | No numerical official minimum published | Practical demand depends on indexing, search, plugins and concurrent access. |
| Storage minimum | No numerical official minimum published | The workspace grows with notes, assets, configuration and local data. |
| Official Docker image | b3log/siyuan | The easiest official server deployment path. |
| Default server port | 6806 | Used by the standard Docker example. |
| Permissions | PUID/PGID configurable | Used to align container ownership with the mounted workspace. |
When to upgrade your hardware
SiYuan rarely needs aggressive hardware scaling; storage growth and whole-host contention are the usual reasons to upgrade.
Workspace assets grow significantly
Indexing/search becomes slower on a large workspace
Other ZimaOS services consume the host headroom
Larger note graphs and assets can increase kernel/indexing work even if basic editing remains light.
Large personal knowledge bases and shared workspaces.Databases, media or AI services may create CPU/RAM pressure that affects SiYuan even when SiYuan itself is light.
All-in-one home servers.Plan hardware growth with confidence
Scale SiYuan primarily through reliable persistent storage and whole-host headroom.
Put the workspace on SSD-backed storage
Fast persistent storage improves file access, indexing and backup operations while keeping the knowledge base off the boot volume.
Use SATA/NVMe storage with ZimaBoard 2 or ZimaCube 2.Add memory for a larger all-in-one server
More RAM is most useful when SiYuan shares the host with databases, AI tools or many other containers.
ZimaBoard 2 1664 provides 16 GB whole-host headroom.Use larger storage for attachment-heavy knowledge bases
Images, PDFs, datasets and other assets can grow much faster than text notes.
ZimaCube 2 Standard is useful when the workspace becomes part of a larger local archive.Protect backups before increasing compute
For a personal knowledge base, reliable backup and restore matter more than adding CPU beyond what the application can use.
Keep an independent copy of the SiYuan workspace on another disk or system.Can it run on ZimaOS?
SiYuan Note is not currently confirmed as a public one-click ZimaOS App Store page in the sources checked for this guide. It can still be deployed cleanly through ZimaOS Install Custom App using the official SiYuan Docker image.
Custom install SiYuan Note in ZimaOS
Use Install Custom App with b3log/siyuan, map port 6806, persist the workspace directory, and set PUID/PGID plus a strong access authentication code.
Custom install SiYuan Note in the ZimaOS app ↗Use the official SiYuan Docker image
SiYuan's upstream repository provides the b3log/siyuan image and Docker/Compose examples for server deployment.
Review SiYuan Docker hosting ↗Configure permissions and WebSocket proxying correctly
The official README documents PUID/PGID ownership and notes that reverse proxies should forward /ws correctly when hiding port 6806.
Review SiYuan server configuration ↗Choose Zima hardware for SiYuan Note
SiYuan's server footprint is modest; hardware choice is mostly about durable workspace storage and the rest of the home-server workload.
Is this a personal knowledge base or a larger attachment-heavy/multi-service server?
Personal or small-team SiYuan
Use ZimaBoard 2 with SSD-backed workspace storage; 8 GB is already generous for the app itself.
- Best starting pointZimaBoard 2 832
- More app headroomZimaBoard 2 1664
Large local archive or broader NAS workload
Choose ZimaCube mainly for storage expansion and backup capacity.
- Storage-first platformZimaCube 2 Standard
These are practical workload recommendations, not official SiYuan performance tiers. Workspace size, assets, plugins and co-hosted services can change requirements.
| Zima hardware | Best for | Example workload | Core configuration | Recommended boundary | Next step |
|---|---|---|---|---|---|
| ZimaBoard 2 832 | Personal and small-team SiYuan knowledge bases. | SiYuan kernel/web UI, workspace indexing, assets and backups. |
|
Add SSD-backed workspace storage; hardware is unlikely to be the bottleneck before the workspace/backup design. | Get Now |
| ZimaBoard 2 1664 | SiYuan plus AI, databases or many other ZimaOS apps. | Larger all-in-one self-hosted workspace with additional services. |
|
16 GB is host-level headroom, not an official SiYuan requirement. | Get Now |
| ZimaCube 2 Standard | Attachment-heavy knowledge bases and larger local archives. | SiYuan workspace plus large media/PDF assets and multi-drive backups. |
|
Choose it for storage topology and archive growth rather than raw SiYuan compute. | Get Now |
What the Press Says
Highlights from trusted reviewers worldwide.
“ZimaCube 2: Not just another NAS, tested with 25TB storage, local AI agents, 4K transcoding, and real homelab workflows.”Read full review
“The ZimaBoard 2 is a compact x86 server board that can be turned into a mini NAS, home server, media box, or self-hosting hub.”Read full review
“ZimaCube 2: A modern, high-performance NAS with plenty of room to grow—built for users who want more than basic storage.”Read full review
“Coverage focused on ZimaCube 2's open hardware foundation, no monthly fee, and self-hosting flexibility.”Read full review
Loved by the Community
Stories and reviews from people who build with Zima every day.
★★★★★
Zima Blade Little yet Powerful
Maybe I am not digital natives but I live with PCs since 12 years old in 1984 when IBM PC clone come to my home. Many years have passed and many operating system I've tried. For me Zima blade and CasaOS was a quantum leap for home PC enthusiast and server lab machine to make me stay curious and relevant for this era.
★★★★★
Very good!!
I use ZimaCube Pro as 5th Proxmox cluster node. It runs several VMs and containers, including a VM with GPU passthrough to run a self-hosted LLM. A specific LXC container runs a Samba server for NAS capabilities using four of six RAID 6 SATA HDDs with ZFS.
★★★★★
Great innovation for mini server!
It is very useful and makes a powerful mini server for many purposes, including university and college students in engineering and electronics. Thank you so much for making this server.
★★★★★
Avaliação ZimaBoard 2
Construí um servidor de uso pessoal. O desempenho está muito bom e funciona perfeitamente onde quer que eu esteja. A surpresa é não dependermos de grandes estruturas para termos nosso próprio servidor de dados. Como iniciante, estou gostando bastante do ZimaOS, pois ele é simples e eficiente.
Frequently asked questions
These answers cover SiYuan RAM, CPU, workspace storage, Docker, permissions and ZimaOS custom installation.
How much RAM does SiYuan Note need?
SiYuan does not publish a numerical Docker-server RAM minimum. A personal instance is lightweight, but memory use can grow with indexing, plugins and other services on the host.
How many CPU cores does SiYuan need?
There is no numerical official core minimum. The main server-side work is the SiYuan kernel, search/indexing and file operations.
How much storage does SiYuan need?
There is no universal upstream disk minimum. Capacity should follow the workspace, attachments, assets and backup retention.
What is the official SiYuan Docker image?
The project documents b3log/siyuan as the official image for Docker hosting.
Does SiYuan need a GPU?
No dedicated GPU is required for normal note editing, backlinks, search and knowledge-base hosting.
Can ZimaBoard 2 run SiYuan?
Yes. The 8 GB model is already a strong personal-server choice; pair it with persistent SSD-backed workspace storage.
Why do PUID and PGID matter for SiYuan Docker?
They control the user/group that accesses the mounted workspace. Incorrect ownership can prevent SiYuan from reading or writing its persistent data.
What should I back up in SiYuan?
Back up the persistent workspace directory because it contains the knowledge base and its local data. Keep an independent copy outside the running container.
What sources informed this SiYuan Note hardware guide?
The guide uses the current official SiYuan repository for Docker, port and permission behavior and current Zima product pages for hardware matching.
