mirror of
https://github.com/BookStackApp/BookStack.git
synced 2026-02-17 19:06:49 +03:00
Backup fails: mysqldump deprecated #5089
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @Backroads4Me on GitHub (Dec 25, 2024).
Describe the Bug
Use the system cli to execute a backup. I have historically done this with a cron job. For example:
/app/www/bookstack-system-cli backup /backups/bookstack.zip
Now the process fails due to mysqldump being deprecated on maria-db for mariadb-dump
Error received:
Checking system requirements...
Dumping the database via mysqldump...
An error occurred when attempting to run a command:
Failed mysqldump with errors:
/usr/bin/mysqldump: Deprecated program name. It will be removed in a future release, use '/usr/bin/mariadb-dump' instead
Steps to Reproduce
Use the system cli to execute a backup.
For example: /app/www/bookstack-system-cli backup /backups/bookstack.zip
Expected Behaviour
bookstack.zip created
Screenshots or Additional Context
No response
Browser Details
No response
Exact BookStack Version
v24.12
@ssddanbrown commented on GitHub (Dec 26, 2024):
Hi @Backroads4Me, Thanks for reporting.
I assume this is within the linuxserver container based upon the commands?
We'll probably need to add specific checks for
mariadb-dumpand use that instead as a higher priority default.@Backroads4Me commented on GitHub (Dec 26, 2024):
That's correct, and it uses image: lscr.io/linuxserver/mariadb
My full uses case is using image: offen/docker-volume-backup to automatically backup Bookstack. Bookstack has historically ran the backup script daily and dumped the zip file to a bound volume then docker-volume-backup exports the zip file to Amazon S3.
@lennart-m commented on GitHub (Mar 2, 2025):
Same issue for me (using linuxserver.io). Are there plans to fix this? I haven't been able to backup my instance since december.
Thanks a lot!
@ssddanbrown commented on GitHub (Mar 12, 2025):
I have now updated the CLI to check for mariadb-dump before defaulting to mysqldump.
The updated CLI will be part of the next patch release, or otherwise can be downloaded here.
Note: Environments using mariadb clients (including mariadb-dump) should also use mariadb as their database server. During testing I've found compatibility is starting to get trickier as those database diverge.