active workspaces, language servers, dependency installs, builds and test processes. Time the job and identify CPU, storage or external-service waits before replacing hardware.
Imports, processing and simultaneous users.OneDev ハードウェア要件: RAM、CPU、ストレージ、ワークスペース、ビルドジョブ
ワークロードに応じたZimaOSのサイジング、バックアップ、実用的なハードウェアの選び方を踏まえて、OneDevのRAM、CPU、永続ストレージ、サービス間の依存関係を計画できます。
OneDev hardware requirements at a glance
OneDev supports Git hosting, issue tracking and CI build execution. Size it around active workspaces, language servers, dependency installs, builds and test processes, including the complete service stack and durable data. An idle editor or control plane does not represent build consumption. Match each workspace image and runtime, and isolate heavy compilation or nested-container jobs when required.
- RAM
- The README describes 2 GB as a comfortable small host; 1 GB personal use requires the documented JVM adjustment.
- CPU
- 2 cores in the comfortable small-host example; 1 core for the adjusted personal-use example.
- Storage
- Git repositories, attachments, indexes and CI artifacts/caches determine retained capacity.
- Required services
- Follow the service topology in the linked upstream deployment for the chosen edition; include every required database, worker and storage service.
- Main sizing variable
- active workspaces, language servers, dependency installs, builds and test processes.
- Practical Zima starting point
- ZimaBoard 2 1664 with SSD-backed active state is an editorial starting point for modest use. Include the OS and all companion services; it is not a measured capacity guarantee.
From official requirements to the right setup
Plan the complete OneDev workload before selecting a server.
-
Official requirements
Choose the exact edition, stable release and supported container/runtime. Follow the service topology in the linked upstream deployment for the chosen edition; include every required database, worker and storage service.
-
Confirm your needs
Test a representative busy operation: active workspaces, language servers, dependency installs, builds and test processes. Record peak resident memory, CPU, disk latency and completion time, including other containers.
-
Leave room to grow
Place active state on reliable persistent storage. Persist workspace files, repositories, extensions, configuration, build caches and artifacts. Budget working space for an upgrade or import and test recovery before relying on the deployment.
-
Run it on ZimaOS
On ZimaOS, use a compatible amd64 container through Custom Install and reproduce all required services, volume mappings and device access. The upstream README describes a 2-core/2-GB machine as a comfortable small host; 1-core/1-GB personal use requires the documented JVM memory adjustment. CI runners and build jobs need additional resources.
Check every playback client
- Exact edition and stable release
- Compatible amd64 image/runtime
- All required companion services
- Realistic peak activity
- Persistent data and file ownership
- Free host ports and reachable URLs
- Working space and backup retention
- Successful database/file restore
Official minimum requirements
Reviewed October 30, 2026 against the linked upstream deployment documentation. Numerical values retain their stated minimum, recommendation or example scope; select release-compatible instructions before installation.
The upstream README describes a 2-core/2-GB machine as a comfortable small host; 1-core/1-GB personal use requires the documented JVM memory adjustment. CI runners and build jobs need additional resources. Numerical examples above retain their stated deployment scope; co-hosted services and independent backups need additional capacity.
| Requirement | Official minimum | What this supports |
|---|---|---|
| RAM guidance | The README describes 2 GB as a comfortable small host; 1 GB personal use requires the documented JVM adjustment. | Official guidance keeps its original test, recommendation or example scope. |
| CPU guidance | 2 cores in the comfortable small-host example; 1 core for the adjusted personal-use example. | Core counts do not predict a fixed user, device or document capacity. |
| Storage planning | Git repositories, attachments, indexes and CI artifacts/caches determine retained capacity. | Installation space is separate from retained content, working files and backups. |
| Service topology | Follow the service topology in the linked upstream deployment for the chosen edition; include every required database, worker and storage service. | Include every stateful companion service in the host budget. |
| Persistent state | Persist workspace files, repositories, extensions, configuration, build caches and artifacts. | An image rebuild or container replacement is not a backup. |
| Deployment boundary | The upstream README describes a 2-core/2-GB machine as a comfortable small host; 1-core/1-GB personal use requires the documented JVM memory adjustment. CI runners and build jobs need additional resources. | Check the linked project instructions for the selected edition and release. |
When to upgrade your hardware
Use observed OneDev workload pressure to decide when an upgrade is warranted.
Busy operations exceed the available window
The complete stack runs short of memory
Persistent data approaches available capacity
Inspect the application and each required service for OOM events, sustained swap or growing queues. Reduce unnecessary concurrency before adding capacity.
Shared hosts and background work.Persist workspace files, repositories, extensions, configuration, build caches and artifacts. Track primary state and backup retention separately.
Long-lived installations and growing collections.Plan hardware growth with confidence
Address storage, memory, compute and deployment limits separately.
Use suitable active storage
Put latency-sensitive application/database state on durable local SSD storage and keep recoverable copies.
SATA or PCIe SSD according to measured data growth.Add memory for the complete stack
Choose a higher-RAM host when peak application and companion-service usage leaves inadequate OS headroom.
ZimaBoard 2 1664 or ZimaCube 2 Pro according to the measured constraint.Separate capacity from compute
A multi-drive system helps when retained content and backup storage are the problem; it is not automatically a faster application.
ZimaCube 2 when a broader multi-drive workload justifies it.Fix the observed bottleneck
The upstream README describes a 2-core/2-GB machine as a comfortable small host; 1-core/1-GB personal use requires the documented JVM memory adjustment. CI runners and build jobs need additional resources.
Check service configuration, I/O and network behavior before selecting a stronger CPU.Can it run on ZimaOS?
Official one-click ZimaOS availability has not been certified for this guide. Use the supported upstream runtime and service topology; consider Custom Install only when a maintained compatible container and all required host capabilities are available.
Custom install OneDev in ZimaOS
Follow the service topology in the linked upstream deployment for the chosen edition; include every required database, worker and storage service. Persist: Persist workspace files, repositories, extensions, configuration, build caches and artifacts.
Custom install OneDev in the ZimaOS app ↗Use the official OneDev deployment instructions
Keep the selected stable release, persistent paths and companion services aligned with upstream documentation.
Review OneDev official installation ↗Check workload-specific deployment details
The upstream README describes a 2-core/2-GB machine as a comfortable small host; 1-core/1-GB personal use requires the documented JVM memory adjustment. CI runners and build jobs need additional resources.
Review OneDev deployment details ↗Which Zima hardware fits OneDev?
Start with the lowest reasonable host for the actual workload. Product specifications were checked against the current product pages.
Which workload best matches your OneDev deployment?
Modest OneDev deployment
Start with durable active data and a measured whole-stack memory budget.
- Workload optionZimaBoard 2 1664
Heavier jobs or more companion applications
Choose added memory or compute only when observed peaks justify the change.
- Workload optionZimaCube 2 Pro
These are practical workload recommendations, not official app requirements, compatibility certification, measured capacity limits or performance guarantees. Include all co-hosted services and independent backups.
| Zima hardware | Best for | Example workload | Core configuration | Recommended boundary | Next step |
|---|---|---|---|---|---|
| ZimaBoard 2 1664 | Modest OneDev workload | active workspaces, language servers, dependency installs, builds and test processes. |
|
This is an editorial host choice, not an official app minimum or a guaranteed user/device capacity. | Get Now |
| ZimaCube 2 Pro | More processing or shared-service headroom | Follow the service topology in the linked upstream deployment for the chosen edition; include every required database, worker and storage service. |
|
Size the combined stack and active working set; more RAM does not fix remote API limits or missing dependencies. | 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
Answers to OneDev RAM, CPU, storage, Docker, database and ZimaOS sizing questions.
How much RAM should I plan for OneDev?
The README describes 2 GB as a comfortable small host; 1 GB personal use requires the documented JVM adjustment. Include ZimaOS, the application and its companion services rather than reserving the entire machine for one container.
What drives the CPU requirement?
2 cores in the comfortable small-host example; 1 core for the adjusted personal-use example. The workload to test is: active workspaces, language servers, dependency installs, builds and test processes.
Which data must survive a container update?
Persist workspace files, repositories, extensions, configuration, build caches and artifacts. Preserve a consistent database/file set and verify that your recovery procedure restores a working application.
What other services belong in the budget?
Follow the service topology in the linked upstream deployment for the chosen edition; include every required database, worker and storage service.
Does this workload need a dedicated GPU?
A dedicated GPU is not assumed for the core workflow described here. Optional AI, acceleration or media-processing integrations must be evaluated separately against the selected backend.
Can I deploy it on ZimaOS?
Use an amd64 container and the current upstream service topology through Custom Install when a suitable maintained image is available. Container availability alone is not a compatibility certification.
What should I check before upgrading hardware?
The upstream README describes a 2-core/2-GB machine as a comfortable small host; 1-core/1-GB personal use requires the documented JVM memory adjustment. CI runners and build jobs need additional resources. Measure the same representative operation before and after a configuration or hardware change.
Which Zima device is a practical starting point?
ZimaBoard 2 1664 is the editorial starting point for this modest deployment. Choose ZimaCube 2 Pro for measured memory/processing pressure or broader shared services; retained data determines storage expansion.
What sources informed this OneDev hardware guide?
This guide was reviewed against the linked project deployment documentation on October 30, 2026. Zima device choices are editorial workload guidance, separate from upstream requirements and measured performance.
