Skip to main content

​
Why developers migrate

Heroku’s dyno model bills for compute hours and add-ons separately, which makes monthly cost hard to predict as an app grows. Square Cloud takes a different approach:
  • Predictable flat pricing in BRL — one plan price covers RAM, vCPU and Blob storage, with no metered add-on bill stacking on top. See Plans and Pricing.
  • Dedicated resources — RAM and vCPU are reserved for your application, not shared best-effort capacity.
  • Deploy in seconds — upload a zip or push via CLI and your application is running, without a build queue.

​
Concept mapping

​
Migration steps

1

Create your configuration file

Replace your Procfile with a squarecloud.app file at the root of your project. A Heroku Procfile like:
becomes:
squarecloud.app
For a worker process type, drop SUBDOMAIN and set START to your worker’s start command instead. See the configuration file reference for every field.
2

Set your environment variables

Export your Heroku Config Vars (heroku config) and set the same keys on Square Cloud, either from the dashboard’s environment variables panel or by uploading a .env file:
3

Deploy

Upload your project via the CLI or the dashboard:
See How to Host your Website/API for a full walkthrough of both methods.
4

Point your DNS

Once the app is live at <subdomain>.squareweb.app, point your domain’s DNS at Square Cloud and attach it from the CLI:
Custom domains require an active Standard plan or higher.

​
Key differences to plan for

  • Region and latency. Square Cloud’s data center is located in New York — see the Platform Overview for infrastructure details. If most of your users are in a different region than your current Heroku dyno region, measure latency before cutting over.
  • No free dyno tier. Square Cloud has no free-dyno equivalent — an active paid plan is required to run any application. See Plans and Pricing to pick the right tier for your workload.
  • Databases move separately. Migrating Heroku Postgres data means exporting it (e.g. pg_dump) and restoring it into a new Square Cloud managed database — plan a maintenance window for the cutover.

​
Contact us

If you continue facing technical difficulties, our specialized support team is available to assist you. Contact us and we’ll be happy to help you resolve any issue — support quality is a big part of why developers rate Square Cloud 4.9/5 across 402 reviews on Google and Trustpilot.