Skip to content

[DOCS-1778] Update minimum Aurora MySQL version #1850

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
merged 6 commits into from
Nov 10, 2025
+9 −6
Merged

[DOCS-1778] Update minimum Aurora MySQL version #1850

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
25d80e6
[DOCS-1778] Update minimum Aurora MySQL version
mdlinville Nov 7, 2025
56ed772
Adjust min MySQL version
mdlinville Nov 7, 2025
114b4ee
Merge branch 'main' into DOCS-1778-mysql-updates
mdlinville Nov 7, 2025
5aca8a1
Apply suggestions from code review
mdlinville Nov 7, 2025
d68794b
Update platform/hosting/self-managed/ref-arch.mdx
mdlinville Nov 7, 2025
7b13b3c
Merge branch 'main' into DOCS-1778-mysql-updates
mdlinville Nov 10, 2025
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
13 changes: 8 additions & 5 deletions platform/hosting/self-managed/bare-metal.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,20 +17,23 @@ Before you start deploying W&B, refer to the [reference architecture](/platform/
## MySQL database

<Warning>
W&B does not recommend using MySQL 5.7. If you are using MySQL 5.7, migrate to MySQL 8 for best compatibility with latest versions of W&B Server. The W&B Server currently only supports `MySQL 8` versions `8.0.28` and above.
MySQL v8.0.x is required, v8.0.32 or newer; v8.0.44 or newer is recommended.
Aurora MySQL 3.x are supported, must be v3.05.2 or newer.
</Warning>

Satisfy the conditions below if you run W&B Server MySQL 8.0 or when you upgrade from MySQL 5.7 to 8.0:
Configure MySQL with these settings:

```
binlog_format = 'ROW'
binlog_row_image = 'MINIMAL'
innodb_flush_log_at_trx_commit = 1
innodb_online_alter_log_max_size = 268435456
max_prepared_stmt_count = 1048576
sort_buffer_size = '67108864'
sync_binlog = 1
innodb_flush_log_at_trx_commit = 1
binlog_row_image = 'MINIMAL'
```

Due to some changes in the way that MySQL 8.0 handles `sort_buffer_size`, you might need to update the `sort_buffer_size` parameter from its default value of `262144`. The recommendation is to set the value to `67108864` (64MiB) to ensure that MySQL works efficiently with W&B. MySQL supports this configuration starting with v8.0.28.
These settings have been validated by W&B.

### Database considerations

Expand Down
2 changes: 1 addition & 1 deletion platform/hosting/self-managed/ref-arch.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ W&B requires object storage with pre-signed URL and CORS support, deployed in on
| Software | Minimum version |
| ------------ | -------------------------------------------- |
| Kubernetes | v1.29 |
| MySQL | v8.0.x releases, must be v8.0.28 or newer|
| MySQL | v8.0.x is required, v8.0.32 or newer; v8.0.44 or newer is recommended.<br/>Aurora MySQL 3.x releases, must be v3.05.2 or newer |
Copy link
Contributor

@dbrian57 dbrian57 Nov 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| MySQL | v8.0.x is required, v8.0.32 or newer; v8.0.44 or newer is recommended.<br/>Aurora MySQL 3.x releases, must be v3.05.2 or newer |
| MySQL | v8.0.32 or newer is required; v8.0.44 or newer is recommended.<br/>Aurora MySQL 3.x releases, must be v3.05.2 or newer |

This reads better to me, but up to you.

Copy link
Contributor Author

@mdlinville mdlinville Nov 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This won't quite work. We support only 8.0.32 - 8.0.44 (current 8.0.x). Next, eventually we will move to 8.4.x.

| Redis | v7.x |

### Networking
Expand Down