More PHP requests and database activity raise CPU and memory demand even though basic page viewing is light.
Growing internal documentation teams.Hårdvarukrav för BookStack: RAM, CPU, databas och lagring
Planera BookStack-maskinvara för RAM, CPU, MySQL eller MariaDB, uppladdningar och säkerhetskopior, med praktiska rekommendationer för anpassad installation av ZimaOS för team.
BookStack requirements at a glance
BookStack is a PHP/Laravel documentation platform backed by MySQL or MariaDB. Current upstream documentation specifies software versions but does not publish numerical server CPU, RAM or storage minimums.
- RAM
- No numerical official minimum published. PHP workers, MySQL/MariaDB and the operating system share the host memory budget.
- CPU
- No numerical official core minimum published. Page rendering and editing are light; imports, image handling and concurrent use add load.
- Storage
- No universal official minimum. Database content, uploaded images/files, logs and backups determine capacity.
- PHP
- Current BookStack requires PHP 8.2 or newer plus the documented PHP extensions.
- Database
- Current requirements are MySQL 8.0+ or MariaDB 10.6+.
- Best Zima starting point
- ZimaBoard 2 832 is ample for a small or medium knowledge base when paired with SSD-backed database and upload storage.
From official requirements to the right setup
Size BookStack as a PHP application plus SQL database and persistent uploads rather than inventing a fixed hardware floor.
-
Official requirements
Start with the current software requirements: PHP 8.2+, MySQL 8.0+ or MariaDB 10.6+, Composer 2.2+ for standard installs, and a PHP-compatible web server.
-
Confirm your needs
Estimate active editors, page count, image/file uploads and import activity. These determine database and storage growth more than the BookStack application files.
-
Leave room to grow
Use durable SSD-backed storage for the database and uploaded content, and back up both because the database alone does not contain all uploaded files.
-
Run it on ZimaOS
On ZimaOS, use Install Custom App with a community-maintained BookStack container such as LinuxServer's plus MariaDB, then persist both services and verify APP_URL/HTTPS.
Check every playback client
- Number of active editors
- Page and book count
- Image/file upload growth
- MySQL or MariaDB choice
- Database persistence
- Upload persistence
- Backup/restore plan
- Other ZimaOS services
Official minimum requirements
BookStack's current installation page provides software prerequisites but no numerical hardware sizing table.
Do not present 1 GB, 2 GB or another guessed number as BookStack's official hardware minimum. A small deployment is lightweight, but whole-host sizing must include the SQL database and persistent uploads.
| Requirement | Official minimum | What this supports |
|---|---|---|
| RAM minimum | No numerical official minimum published | Upstream requirements focus on the software stack rather than host RAM. |
| CPU minimum | No numerical official minimum published | Concurrency, imports and image/file handling determine practical demand. |
| Storage minimum | No numerical official minimum published | Database, uploads, logs and backups determine disk use. |
| PHP | PHP 8.2+ | Current BookStack requirement. |
| Database | MySQL 8.0+ or MariaDB 10.6+ | Current BookStack requirement. |
| Docker status | Community container setups | BookStack's own docs list LinuxServer.io and solidnerd as community Docker options rather than official production images. |
When to upgrade your hardware
BookStack usually needs more resources when database/cache activity, uploads or the wider collaboration stack grows.
Concurrent editing and page traffic increase
Images and file attachments grow
The SQL database competes with other apps
Uploaded content can become the main storage driver and increases backup time.
Screenshot-heavy technical documentation and file-rich knowledge bases.Database cache and I/O become more important as BookStack shares the host with other productivity services.
All-in-one ZimaOS servers.Plan hardware growth with confidence
Scale BookStack by protecting the database and upload path before adding raw compute.
Put MySQL/MariaDB and uploads on SSD
Fast persistent storage improves database responsiveness and protects a growing documentation repository.
Use SATA/NVMe storage with ZimaBoard 2 or SSD tiers on ZimaCube 2.Move to 16 GB for a broader app stack
Extra RAM is useful when BookStack, MariaDB and many other services share one host.
ZimaBoard 2 1664 provides 16 GB whole-host headroom.Use larger storage for image-heavy documentation
Screenshots, diagrams, attachments and retained backups can outgrow the application/database footprint.
ZimaCube 2 Standard is a storage-first option.Separate the database only when monitoring justifies it
Small BookStack installations rarely need multi-node architecture; separate services when database contention becomes measurable.
Use stronger or separate infrastructure only after identifying the bottleneck.Can it run on ZimaOS?
BookStack is not currently confirmed as a public official one-click ZimaOS App Store page in the sources checked for this guide. It can still be deployed through Install Custom App using a community BookStack container and SQL database.
Custom install BookStack in ZimaOS
Use Install Custom App with a maintained BookStack image such as LinuxServer's plus MariaDB, persist application uploads/config and database data, and configure APP_URL plus HTTPS.
Custom install BookStack in the ZimaOS app ↗Match BookStack's current software requirements
BookStack currently requires PHP 8.2+ and MySQL 8.0+ or MariaDB 10.6+ for standard installations.
Review BookStack installation requirements ↗Use community Docker images deliberately
BookStack's docs explicitly list LinuxServer.io and solidnerd as community Docker setups rather than project-maintained production images.
Review BookStack Docker options ↗Choose Zima hardware for BookStack
BookStack is light enough for ZimaBoard 2; storage and whole-host memory matter more as uploaded documentation and companion apps grow.
Is this a small-team knowledge base or a larger documentation/archive server?
Small or medium team
Use ZimaBoard 2 with SSD-backed database and uploads; CPU is unlikely to be the first limit.
- Best starting pointZimaBoard 2 832
- More app headroomZimaBoard 2 1664
Large image/archive footprint or broader NAS workload
Use ZimaCube when attachments and backups make storage topology the main concern.
- Storage-first platformZimaCube 2 Standard
These are practical recommendations, not official BookStack user-count or throughput tiers.
| Zima hardware | Best for | Example workload | Core configuration | Recommended boundary | Next step |
|---|---|---|---|---|---|
| ZimaBoard 2 832 | Small and medium BookStack teams. | BookStack, MariaDB/MySQL, uploads, backups and light companion services. |
|
Add SSD-backed database/upload storage; eMMC should not be the only durable location for an important knowledge base. | Get Now |
| ZimaBoard 2 1664 | BookStack plus many other productivity services. | Larger database cache, more PHP concurrency and broader container consolidation. |
|
16 GB is practical host headroom, not an official BookStack requirement. | Get Now |
| ZimaCube 2 Standard | Image-heavy documentation and long backup retention. | BookStack with large upload libraries plus multi-drive NAS duties. |
|
Choose it mainly for storage topology; BookStack itself does not require a six-bay NAS. | 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 BookStack RAM, CPU, MySQL/MariaDB, uploads, Docker and ZimaOS deployment.
How much RAM does BookStack need?
BookStack does not publish a numerical server RAM minimum. Practical RAM must cover PHP, MySQL/MariaDB, the OS and other services.
How many CPU cores does BookStack need?
There is no numerical official core minimum. Concurrent requests, imports and image/file handling drive practical CPU demand.
How much storage does BookStack need?
There is no universal official disk minimum. Size for the SQL database, uploaded images/files, logs and backup retention.
Which database does BookStack require?
Current BookStack requirements are MySQL 8.0 or newer, or MariaDB 10.6 or newer.
Does BookStack need an SSD?
SSD is not an official hard requirement, but SSD-backed database and upload persistence is a strong practical choice.
Does BookStack need a GPU?
No dedicated GPU is required for documentation, editing, search or normal image handling.
Can ZimaBoard 2 run BookStack?
Yes. The 8 GB model is already ample for a small or medium deployment when paired with durable SSD-backed database and upload storage.
Does BookStack provide an official Docker image?
BookStack's installation documentation currently points to community Docker setups such as LinuxServer.io and solidnerd rather than a project-maintained production container.
What sources informed this BookStack hardware guide?
The guide uses BookStack's current installation documentation and current Zima product pages for hardware matching.
