BookStack vs Valkey

What BookStack is

BookStack is an MIT-licensed, self-hosted documentation application built around shelves, books, optional chapters and pages. It provides role and content-level permissions, multiple enterprise authentication options and a permission-aware REST API, but the operator remains responsible for the PHP and database stack, upgrades, filesystem permissions, security configuration and complete database-plus-file backups.

What Valkey is

Valkey is a BSD-licensed, vendor-neutral in-memory data structure server descended from Redis OSS 7.2.4. It supports RESP2/RESP3 clients, replication, Sentinel, Cluster, transactions, scripting, Pub/Sub, streams and configurable RDB or AOF persistence. Compatibility is strongest with Redis OSS 7.2 and earlier; Redis Community Edition 7.4+ data files are not compatible. Secure deployment is not automatic and requires network isolation, access control and, where needed, TLS.

What BookStack is built to do

Book hierarchy

Organizes page content within optional chapters, books and reusable bookshelves.

Roles and permissions

Combines system roles with content-level overrides and inherited controls.

Federated authentication

Documents OIDC, SAML 2.0 and LDAP configuration for self-hosted instances.

REST API

Provides token-authenticated JSON endpoints governed by the API user's permissions.

What Valkey is built to do

Rich data structures

Stores strings, hashes, lists, sets, sorted sets, streams and specialized structures in memory.

Persistence choices

Supports periodic RDB snapshots, append-only logging, both together or no persistence.

Replication and failover

Uses asynchronous replication with Sentinel or Cluster deployment patterns.

RESP compatibility

Supports RESP2 and RESP3 and a documented migration path from Redis OSS through 7.2.

Choose BookStack if

• Internal handbooks, runbooks and technical knowledge bases with a clear hierarchy
• Organizations needing self-hosting, role controls and supported identity integrations
• Teams that can automate upgrades, database and file backups, and restore drills

Skip BookStack if

• You need a vendor-operated SaaS with no infrastructure responsibility
• Your information model cannot fit shelves, books, chapters and pages
• You cannot preserve the database, uploads, configuration and original APP_KEY together

Choose Valkey if

• Caches, ephemeral state, rate limits, queues, streams and real-time application data
• Redis OSS 7.2-or-earlier migrations validated against the actual client, modules and persistence files
• Teams that can operate protected standalone, Sentinel or Cluster deployments

Skip Valkey if

• The system requires disk-first durability or zero acknowledged-write-loss guarantees
• A Redis CE 7.4+ data file must be opened directly without a supported migration route
• The service would be internet-exposed or deployed without firewall, ACL and recovery controls

BookStack: pros & cons

• Predictable structure: Shelves, books, chapters and pages give teams a constrained documentation hierarchy.
• Granular access: Roles can be combined and overridden at shelf, book, chapter or page level.
• Authentication choices: Official administration docs cover OpenID Connect, SAML 2.0 and LDAP.
• Automation surface: The REST API covers content and administrative resources while enforcing the API user's roles and permissions.
• Self-hosting burden: PHP, MySQL or MariaDB, web-server configuration, updates and monitoring are operator responsibilities.
• Manual recovery design: There is no built-in full backup and restore; both database records and instance files must be protected.
• Key dependency: Restores need the original APP_KEY for encrypted features such as multi-factor credentials.
• Hierarchy trade-off: The book metaphor is approachable but may constrain teams needing free-form graphs or complex publishing workflows.

Valkey: pros & cons

• Permissive open source: The server is community-developed under the BSD 3-Clause license.
• Familiar ecosystem: RESP clients and Redis OSS 7.2-era configurations, modules and data formats ease many migrations.
• Flexible roles: Data structures, expiry, scripting, transactions, Pub/Sub and streams cover cache and real-time patterns.
• Scale and availability options: Replication, Sentinel and Cluster support failover and sharding topologies.
• Compatibility has a boundary: Redis CE 7.4+ files are incompatible and future Valkey behavior can diverge.
• Unsafe defaults require hardening: Official guidance warns against direct internet exposure and calls for firewalling, binding, ACL/authentication and optional TLS.
• Durability is configurable: RDB, AOF and no-persistence modes have different data-loss, latency and recovery tradeoffs.
• Cluster consistency limits: Asynchronous replication allows windows of acknowledged-write loss, especially during minority partitions.