Skip to content

perf: run the dump and zip in a low-priority child process #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ChatDisabled merged 3 commits into from
Oct 21, 2026
Merged

perf: run the dump and zip in a low-priority child process #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
2123d13
perf: run the dump and zip in a low-priority child process
ChatDisabled Oct 3, 2026
52ff556
docs: describe the low-priority backup process
ChatDisabled Oct 3, 2026
76d60c8
build: update distribution bundle
ChatDisabled Oct 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,8 @@ ensure qbx_db_backup
3. Restart the server.

The permission line is required: FiveM blocks resources from starting programs unless you allow
it, and the backup runs `mariadb-dump` as a separate process so the server never slows down.
it, and the dump, compression and checksum all run in a separate low-priority process so the server
never slows down.

## Usage

Expand Down Expand Up @@ -96,7 +97,7 @@ Everything has a working default. The resource reads the database credentials fr
| `qbx_db_backup_s3_keep` | `0` | Number of backups to keep in the S3 bucket prefix (0 disables count pruning). |
| `qbx_db_backup_s3_max_age_days` | `0` | Delete S3 backups older than this many days (0 disables age pruning). |
| `qbx_db_backup_zip_level` | `6` | Compression level, 1 (fastest) to 9 (smallest). Lower levels use noticeably less CPU for slightly larger zips. |
| `qbx_db_backup_max_mb_per_second` | `10` | Pace the dump to this many MB of SQL per second so a backup never competes with the game server for CPU. 0 removes the limit. |
| `qbx_db_backup_max_mb_per_second` | `10` | Pace the dump to this many MB of SQL per second to limit the load a backup puts on the database and the disk. 0 removes the limit. |
| `qbx_db_backup_timeout_minutes` | `120` | Give up on a backup after this long. |
| `qbx_db_backup_dump_bin` | (empty) | Path to your own `mariadb-dump` or `mysqldump` instead of the bundled one. |

Expand Down
Loading
Loading