This guide shows how to migrate your Render database to Hydra. This migration requires the pg_dump and psql CLI tools, which are installed automatically as part of the complete PostgreSQL installation package.

Retrieve your Render database credentials

  1. Log in to your Render account and select the project you want to migrate.
  2. Click Dashboard in the menu and click in your Postgres database.
  3. Scroll down in the Info tab.
  4. Click on PSQL Command and edit it adding the content after PSQL_COMMAND=.

Example:

env PSQL_COMMAND=PGPASSWORD=RgaMDfTS_password_FTPa7 psql -h dpg-a_server_in.oregon-postgres.render.com -U my_db_pxl0_user my_db_pxl0

Retrieve your Hydra connection string

  1. If you’re new to Hydra, create a project.
  2. Go to the Project section for your project in the Hydra Platform.

Migrate the database

  1. Export your Render database to a file in console

    Use pg_dump with your Render credentials to export your Render database to a file (e.g., render_dump.sql).

    pg_dump --clean --if-exists --quote-all-identifiers -h $RENDER_HOST -U $RENDER_USER -d $RENDER_DATABASE --no-owner --no-privileges > render_dump.sql

  2. Import the database to your Hydra project

    Use psql to import the Render database file to your Hydra project.

    psql -d "$YOUR_CONNECTION_STRING" -f render_dump.sql

Additional options

  • To only migrate a single database schema, add the --schema=PATTERN parameter to your pg_dump command.
  • To exclude a schema: --exclude-schema=PATTERN.
  • To only migrate a single table: --table=PATTERN.
  • To exclude a table: --exclude-table=PATTERN.

Run pg_dump --help for a full list of options.

  • If you’re planning to migrate a database larger than 6 GB, we recommend upgrading to at least a Medium compute instance. This will ensure you have the necessary resources to handle the migration efficiently.
  • You can increase the size of the disk on paid projects by navigating to the project Settings tab.
  • 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.

Enterprise

Contact us if you need more help migrating your project.