# Migrate from PlanetScale to Layerbase

> Move a PlanetScale MySQL or Postgres database to Layerbase in minutes. Guided read-once migration with a disposable read-only credential. Free tier available.

Canonical: https://layerbase.com/migrate/planetscale
Generated from Layerbase source: 2026-11-17

PlanetScale runs MySQL and Postgres, and Layerbase hosts both. Paste a service token and we move a MySQL database to managed MySQL or MariaDB using a short-lived read-only password we mint and then delete. A PlanetScale Postgres database comes across with its connection string. Read-once either way, and nothing is written back.

## Key facts

| Fact | Value |
| --- | --- |
| Source platform | PlanetScale |
| Layerbase target engines | MySQL, MariaDB |
| How you connect | Connect your account with an API key |
| Source modified | No: read-once copy, credentials never stored |

## Why switch from PlanetScale

### Both engines, standard tools

PlanetScale runs MySQL and Postgres; Layerbase hosts both, with normal connection strings, TLS, backups every 12 hours on paid plans, and a web SQL console on either side. mysqldump, psql, your ORM, and every client you already use work unchanged.

### Flat plans, and a real Free tier

MariaDB and Postgres both run on the Free tier, and MySQL starts on the $5/mo Solo plan. One price for the database: no row-read counters or per-branch charges to model before you know your bill.

### A safe, disposable credential

For the MySQL database you pick we mint a short-lived read-only password, copy from it, then delete it. Your real credentials never leave PlanetScale and nothing is written to the source.

### Land on the engine you want

A PlanetScale MySQL database can land on Layerbase MySQL or MariaDB, which are wire-compatible. PlanetScale Postgres lands on Layerbase Postgres, branching included. Pick the target during the import.

## How the migration works

1. **Create a free account or sign in.** Sign in with Google or GitHub. No credit card is needed to start, and the migration wizard opens with this platform already selected.
2. **Connect your account.** Paste a PlanetScale service token and its ID (Settings, then Service tokens). We list your databases; for the one you pick we mint a short-lived read-only password, copy from it, then delete it. The token needs an org-level read-databases permission.
3. **Pick what to migrate and name it.** Choose what to bring over, give the new Layerbase database a name, and start the migration. Progress streams live in the dashboard.
4. **We copy it in one pass.** The migration reads from PlanetScale once and never writes to it. Credentials are used for the copy and never stored. When it finishes, you land in your new database with a live TLS connection string.

## Common PlanetScale migration questions

### Will my PlanetScale database be modified?

No. For a MySQL database we mint a short-lived read-only password, copy the schema and data in one pass, then delete that credential. A Postgres source is read through the connection string you supply. Nothing is written to PlanetScale either way.

### Can you migrate PlanetScale Postgres, not just MySQL?

Yes. PlanetScale Postgres is standard Postgres, so it comes across with a connection string: choose the Other Postgres source in the wizard and paste it. The service-token flow below is the guided path for PlanetScale MySQL databases.

### What does the service token need?

An org-level read-databases permission (Settings, then Service tokens). We use the token once to list your databases and mint the temporary read-only password, and it is never stored.

### Do I need to stop writes during the copy?

The copy is a single point-in-time pass, so writes that land after it starts are not included. For an exact cutover, pause writes briefly or re-run the migration into a fresh database at switch time.

### Is there a free tier?

Postgres and MariaDB both have a Free tier, so a PlanetScale database can land at no cost on either. MySQL starts on the $5/mo Solo plan. Every plan includes the full dashboard, backups, and TLS.

## Links

- [Migrate from PlanetScale](https://layerbase.com/migrate/planetscale)
- [MySQL on Layerbase](https://layerbase.com/db/mysql) (markdown: https://layerbase.com/db/mysql.md)
- [MariaDB on Layerbase](https://layerbase.com/db/mariadb) (markdown: https://layerbase.com/db/mariadb.md)
- [Cloud migration guide](https://layerbase.com/docs/cloud/migrate)
- [Pricing](https://layerbase.com/pricing) (markdown: https://layerbase.com/pricing.md)
