Skip to content

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

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

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

Conversation

@promptless-for-oss
Copy link
Copy Markdown

@promptless-for-oss promptless-for-oss commented Apr 21, 2026

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-for-oss
promptless-for-oss commented Apr 21, 2026
View reviewed changes
Comment thread docs/getting_started/how_to_install_mautic.rst
Copy link
Copy Markdown
Author

@promptless-for-oss promptless-for-oss Apr 21, 2026

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

promptless-for-oss
promptless-for-oss commented Apr 21, 2026
View reviewed changes
Comment thread docs/getting_started/how_to_install_mautic.rst

* 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

@promptless-for-oss promptless-for-oss Apr 21, 2026

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
escopecz
escopecz requested changes Apr 21, 2026
View reviewed changes
Comment thread docs/getting_started/how_to_install_mautic.rst Outdated
adiati98
adiati98 requested changes Apr 21, 2026
View reviewed changes
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
adiati98
adiati98 reviewed Apr 21, 2026
View reviewed changes
Comment thread docs/getting_started/how_to_install_mautic.rst Outdated
@promptless-for-oss
Copy link
Copy Markdown
Author

promptless-for-oss commented Apr 25, 2026

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.

@adiati98 adiati98 added this to the Mautic 7.2 milestone May 18, 2026
@adiati98
Copy link
Copy Markdown
Contributor

adiati98 commented May 26, 2026

@promptless-for-oss please rebase to 7.2

promptless Bot and others added 3 commits May 26, 2026 11:05
@promptless @claude
Add PostgreSQL database support to installation documentation
0accd1b 
- 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>
@adiati98 @promptless
fix: revert to original version
9913b47
@promptless
Address PR review comments: change parentheses to dashes for consistency
0e8bf98 
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 promptless-for-oss force-pushed the promptless/postgresql-support branch from 823bbe3 to 0e8bf98 Compare May 26, 2026 11:06
@promptless-for-oss
Copy link
Copy Markdown
Author

promptless-for-oss commented May 26, 2026

The branch has been rebased onto 7.2. The commits are now cleanly based on 7.2.

Note: The PR's base branch in GitHub still shows 7.1 because I cannot update PR metadata via API. A maintainer will need to manually change the base branch from 7.1 to 7.2 using GitHub's UI (Edit button → Base dropdown).

@adiati98 adiati98 changed the base branch from 7.1 to 7.2 May 26, 2026 11:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@adiati98 adiati98 adiati98 requested changes

@escopecz escopecz escopecz requested changes

+1 more reviewer

@wieslawgolec wieslawgolec wieslawgolec left review comments

Reviewers whose approvals may not affect merge requirements

Requested changes must be addressed to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

Mautic 7.2

Development

Successfully merging this pull request may close these issues.

4 participants

@promptless-for-oss @adiati98 @escopecz @wieslawgolec