Home

Migrate Your MySQL Database to Supabase

This guide aims to exhibit the process of transferring your MySQL database to Supabase's Postgres database. Supabase is a robust and open-source platform offering a wide range of backend features, including a PostgreSQL database, authentication, instant APIs, edge functions, real-time subscriptions, and storage. Migrating your MySQL database to Supabase's PostgreSQL enables you to leverage PostgreSQL's capabilities and access all the features you need for your project.

Retrieve Your MySQL Database Credentials#

Before you begin the migration, you need to collect essential information about your MySQL database. Follow these steps:

  1. Log in to your MySQL database provider.

  2. Locate and note the following database details:

    • Hostname or IP address
    • Database name
    • Username
    • Password

Retrieve your Supabase Host #

  1. If you're new to Supabase, create a project.
  2. Go to the Database settings for your project in the Supabase Dashboard.
  3. Under Connection Info, note your Host ($SUPABASE_HOST).
  4. Save your password or reset it if you forgot it.

Finding Supabase host address

Migrate the database#

The fastest way to migrate your database is with the Supabase migration tool on Google Colab.

Alternatively, you can use pgloader, a flexible and powerful data migration tool that supports a wide range of source database engines, including MySQL and MS SQL, and migrates the data to a Postgres database. For databases using the Postgres engine, we recommend using the pg_dump and psql command line tools, which are included in a full PostgreSQL installation.

  1. Select the Dabase Engine from the Source database in the dropdown
  2. Set the environment variables (HOST, USER, SOURCE_DB,PASSWORD, SUPABASE_URL, and SUPABASE_PASSWORD) in the Colab notebook.
  3. Run the first two steps in the notebook in order. The first sets engine and installs the necessary files.
  4. Run the third step to start the migration. This will take a few minutes.

caution

  • If you're planning to migrate a database larger than 6 GB, we recommend upgrading to at least a Large compute add-on. This will ensure you have the necessary resources to handle the migration efficiently.

  • For databases smaller than 150 GB, you can increase the size of the disk on paid projects by navigating to Database Settings.

  • If you're dealing with a database larger than 150 GB, we strongly advise you to contact our support team for assistance in provisioning the required resources and ensuring a smooth migration process.

© Supabase Inc—ContributingAuthor StyleguideOpen SourceSupaSquad