Skip to content

Document MySQL port availability before startup#604

Open
93jun wants to merge 1 commit into
geerlingguy:masterfrom
93jun:document-mysql-port-requirement
Open

Document MySQL port availability before startup#604
93jun wants to merge 1 commit into
geerlingguy:masterfrom
93jun:document-mysql-port-requirement

Conversation

@93jun

@93jun 93jun commented Jul 6, 2026

Copy link
Copy Markdown

This adds a short Requirements note that the configured MySQL/MariaDB port must
be available before the role starts the service.

The role already documents mysql_enabled_on_startup and the default
mysql_port: "3306". If another MySQL/MariaDB instance or local service is
already bound to the configured port, startup can fail or later database module
operations may not connect to the expected service.

This change documents the operational precondition directly in the README:

  • when mysql_enabled_on_startup is true, ensure mysql_port is available
  • stop or reconfigure any existing MySQL/MariaDB instance using the same port
  • set mysql_port to an available port before startup if needed

Validation:

git diff --check

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant