I have an existing Craft installation using MySQL and I've only recently realized the error of my ways and would like to convert the database to PostgreSQL.

Is this possible?

1 Answer 1


First, I'm glad you've realized what a mistake you made.

There's not a fool-proof way to do this, other than to do a fresh installation of Craft using PostgreSQL and migrate the content over.

There is a tool called pgloader that purports to be able to convert a MySQL/MariaDB database into PostgreSQL and it gives it the old college try.

My experience is that it works a good 70% of the time depending on things like environmental configurations and the size/complexity of the original database, so here's hoping luck is on your side.

Be sure and check their issues if you run into any errors.

Make backups. YMMV. UAYOR. Test the #@*! out of the resulting database.

What You’ll Need

  • An existing Craft CMS install that uses MySQL or MariaDB
  • Running MySQL and PostgreSQL servers, and the DSN for each
  • pgloader


  1. Download and install pgloader. If you’re on a Mac, you can use brew install pgloader.

  2. Save and customize a local command file* for pgloader:

        FROM mysql://root:root@mariadb/craft3
        INTO pgsql://craft3:secret@postgres/craft3
        WITH quote identifiers
    CAST type datetime to timestamp
    ALTER SCHEMA 'craft3' RENAME TO 'public'
        $$ ALTER TABLE craft_searchindex ADD COLUMN keywords_vector tsvector; $$,
        $$ UPDATE craft_searchindex SET keywords_vector = CAST (keywords as tsvector); $$,
        $$ ALTER TABLE craft_searchindex ALTER COLUMN keywords_vector SET NOT NULL; $$

    This one assumes your MySQL username and password are root, the host is mariadb, and the source database is craft3. The PostgreSQL username and password are craft3 and secret, the host is postgres, and the target PGSQL database is craft3.

    Be sure to adjust the craft_ table prefix to match whatever you’re using on your MySQL database.

    If you need to specify a port for either DSN, append a colon and that number to the hostname. (For example, specifying port 3306 for mysql would become mysql://root:root@mariadb:3306/craft3).

  3. Tell pgloader to read the MySQL database into PostgreSQL:

    pgloader /path/to/command-file

    Example conversion output, which includes useful stats and warnings.

enter image description here

*Why use a command file?

You could run pgloader mysql://root:root@mariadb/craft3 postgresql://craft3:secret@postgres/postgres/craft3, but column names would all be lowercased, some critical type conversions and search index updates would be missing, and using a password in any terminal command is usually a bad idea since it will be visible in that shell’s command history.

  • So you're recommending PostgresSQL over MySQL?
    – gioppe
    Commented Jul 16, 2020 at 10:35
  • 1
    As always, "it depends". I personally prefer it.
    – Brad Bell
    Commented Jul 17, 2020 at 5:24
  • You have my sincerest thanks for this guide, especially the extra column fixes. I finally got this flaming Craft site migrated after days of hacking. Hopefully this is the last time I will ever need to go through this! Commented Jun 1, 2023 at 21:59
  • I attempted to use this method but I'm running into multiple errors which I'm not sure are related to postgres or the data. Anyone could take a look? craftcms.stackexchange.com/questions/41258/…
    – cballenar
    Commented Nov 5, 2023 at 13:13

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.