Skip to content

docs: Document PostgreSQL database support for Mautic 7.x#697

Draft
promptless-for-oss wants to merge 17 commits into
mautic:7.1from
Promptless:promptless/postgresql-support
Draft

docs: Document PostgreSQL database support for Mautic 7.x#697
promptless-for-oss wants to merge 17 commits into
mautic:7.1from
Promptless:promptless/postgresql-support

Conversation

@promptless-for-oss
Copy link
Copy Markdown

Open this suggestion in Promptless to view citations and reasoning process

Documents the reintroduction of PostgreSQL database support in Mautic 7.x based on PR #15926.

Changes

how_to_install_mautic.rst

  • Preparing for installation: Added explicit database version requirements - 'Mautic 7 supports MySQL 8.4+, MariaDB 10.11+, and PostgreSQL 16+'
  • Integrating the database: Updated driver selection to list both MySQL PDO and PostgreSQL PDO options with appropriate port numbers
  • Command-line installation: Updated --db_driver documentation to show both pdo_mysql and pdo_pgsql options with port guidance
  • local.php examples: Added separate MySQL/MariaDB and PostgreSQL configuration examples with correct port numbers (3306 vs 5432)
  • Install command examples: Added both MySQL/MariaDB and PostgreSQL command-line installation examples

Key Feature Details from PR #15926

  • PostgreSQL 16+ now officially supported alongside MySQL 8.4+ and MariaDB 10.11+
  • Fully functional installer works identically across all three database engines
  • All migrations, unit tests, and functional tests pass on PostgreSQL
  • No breaking changes for existing MySQL/MariaDB users

Tip: Worried about broken links? Ask Promptless to find and fix them automatically 🔗

promptless Bot and others added 13 commits March 25, 2026 16:07
- Add supported database versions (MySQL 8.4+, MariaDB 10.11+, PostgreSQL 16+)
- Document MySQL PDO and PostgreSQL PDO driver options in web installer
- Add PostgreSQL local.php configuration example
- Add PostgreSQL command line installation example
- Update CLI help text with database driver options (pdo_mysql, pdo_pgsql)
- Add default port guidance (3306 for MySQL/MariaDB, 5432 for PostgreSQL)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

(Line 75)

PostgreSQL database support reintroduced in PR #15926. Supported range: PostgreSQL 16+, PHP 8.2+. Affects database integration section in docs/getting_started/how_to_install_mautic.rst.

Source: mautic/mautic#15926


* Your server environment meets the minimum requirements for the version you are installing. Read more in :xref:`Mautic's Requirements`.

* Your server directory is writable by the Mautic web server.
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

PR #15926 reintroduces PostgreSQL database support in Mautic 7.x. Supported versions: PostgreSQL 16+, MySQL 8.4+, MariaDB 10.11+. Changes in how_to_install_mautic.rst.

Source: mautic/mautic#15926

@adiati98 adiati98 requested a review from a team April 21, 2026 09:34
Comment thread docs/getting_started/how_to_install_mautic.rst Outdated
Copy link
Copy Markdown
Contributor

@adiati98 adiati98 left a comment

Choose a reason for hiding this comment

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

@promptless-for-oss please address the suggestions.

Comment thread docs/getting_started/how_to_install_mautic.rst Outdated
Comment thread docs/getting_started/how_to_install_mautic.rst Outdated
Comment thread docs/getting_started/how_to_install_mautic.rst Outdated
Comment thread docs/getting_started/how_to_install_mautic.rst Outdated
adiati98 and others added 4 commits April 21, 2026 17:37
Updates formatting per reviewer feedback:
- Database Port field: parentheses to dashes for port numbers
- --db_driver help text: parentheses to dashes, add quotes around values
- --db_port help text: parentheses to dashes for port numbers
@promptless-for-oss
Copy link
Copy Markdown
Author

I've addressed the review feedback:

Changes made:

  • Reverted line 34 to original wording — keeping the requirements link as single source of truth instead of hardcoding version numbers (as @escopecz suggested, since PostgreSQL won't be available until 7.2+)
  • Changed parentheses to dashes for consistency in database port and driver documentation (as @adiati98 suggested)

Ready for re-review.

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.

4 participants