BookStack vs Cloudant

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 Cloudant is

IBM Cloudant is a proprietary managed JSON document database built on Apache CouchDB, with a compatible HTTPS API and replication protocol. The Lite plan is free for evaluation and fixes capacity at 20 reads, 10 writes and five global queries per second with 1 GB storage. Standard begins at one provisioned capacity block—100 reads, 50 writes and five global queries per second—includes 20 GB and bills capacity plus excess storage hourly. Dedicated Hardware adds workload isolation, private networking and selected compliance and key-management options. A Cloudant service is not the same as self-hosting CouchDB.

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 Cloudant is built to do

JSON document database

Stores schema-flexible documents, attachments and secondary indexes behind HTTPS APIs.

CouchDB-compatible replication

Supports replication patterns between Cloudant regions and compatible CouchDB systems.

Provisioned throughput

Scales read, write and global-query capacity in linked blocks through the dashboard or API.

IBM IAM and SDKs

Integrates IBM Cloud access controls and provides supported Java, Node.js, Python, Swift, Go and mobile clients.

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 Cloudant if

• Offline or distributed applications that benefit from CouchDB-style replication
• JSON workloads dominated by key lookups and well-designed partitioned queries
• Teams able to test request-class capacity, 429 handling and multi-region conflicts

Skip Cloudant if

• The application depends on relational joins, broad ad-hoc SQL or multi-document ACID transactions
• Traffic is too unpredictable to provision and monitor request-class capacity
• A free Lite instance is being treated as a production SLA or scalable datastore

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.

Cloudant: pros & cons

• Managed document service: IBM handles database servers, upgrades, patching and core high-availability infrastructure.
• CouchDB lineage: Compatible HTTP APIs and replication ease selected CouchDB application and migration patterns.
• Explicit capacity model: Read, write and global-query throughput are provisioned in documented blocks.
• Multi-region option: Application-managed replication can support active-active regional architectures.
• Lite is evaluation capacity: It cannot scale and blocks new writes above its storage limit.
• Capacity dimensions scale together: A workload dominated by one request class may pay for unused allowances in the others.
• Exceeding throughput returns 429: Applications need retry, backoff and load testing rather than assuming automatic unlimited scale.
• Cross-region is not automatic application resilience: Conflict behavior, traffic routing, monitoring and recovery remain design responsibilities.