Infrastructure-as-code templates for provisioning a migration instance pre-configured with pgcopydb and the PlanetScale migration helper scripts. Each template creates a compute instance running Ubuntu 24.04 that installs pgcopydb, PostgreSQL client tools, and the helper scripts at boot.
| Template | Platform | Tool | README |
|---|---|---|---|
| AWS CloudFormation | AWS EC2 | CloudFormation | README |
| AWS Terraform | AWS EC2 | Terraform | README |
| GCP Terraform | GCP Compute Engine | Terraform | README |
All three templates produce an equivalent migration instance — choose based on your cloud provider and preferred provisioning tool.
- A compute instance with pgcopydb and PostgreSQL 18 client tools
- An attached data volume for migration working data
- Network and access configuration (security group/firewall rule, IAM/SSH via SSM or IAP)
- Migration helper scripts from this repo deployed to
/home/ubuntu/
Once the instance is running, connect to it and follow the migration workflow starting with setting up ~/.env and ~/filters.ini.