BookStack icon indicating copy to clipboard operation
BookStack copied to clipboard

Replicate cleanly a page between 2 different instances of BookStack

Open fabm22 opened this issue 9 months ago • 1 comments

Attempted Debugging

  • [x] I have read the debugging page

Searched GitHub Issues

  • [x] I have searched GitHub for the issue.

Describe the Scenario

Let's say I have 2 instances of BookStack, perhaps one destined to be more restrictive than another in terms of access (and I don't want to use roles etc).

Question : is there a known ("official"-ish, elegant) way to replicate a page (or book, shelf..) on-demand from instance A to instance B whitout manual export import ? Is there an existing functionnality that does something like that "cleanly" (eventually through automation at some point) ? If not, perhaps through a SQL query that will not break often hopefully on update of Bookstack? Would this typically require for both instances to be on exact same version of Bookstack?

Thanks for your help.

Exact BookStack Version

v25.02

Log Content

No response

Hosting Environment

Based on non-oficial Dockerfile from github ( solidnerd/bookstack )

fabm22 avatar Mar 25 '25 11:03 fabm22

Hi @fabm22,

The most "official" means of this currently would be the newly added import/export ZIP functionality: https://www.bookstackapp.com/blog/bookstack-release-v24-12/#new-importable-export-format

Though this does not yet have automation support, since it's not yet part of our API (wanting some feedback/testing before proceeding to roll out to the API), but that is something I'd want to add some time this year. Even with this added, it may only be ideal for one-way data replication. Things get a lot more complex with dual-direction syncing.

Otherwise, it could be possible to automate replication using the REST API of the two instances, but there can be edge-cases to deal with which can make this a little involved (image/attachment/tag handling).

ssddanbrown avatar Mar 25 '25 11:03 ssddanbrown