Skip to main content

​
What you get on Square Cloud

  • Predictable flat pricing in BRL: one monthly plan price covers the RAM and vCPU your applications use. See Plans and Pricing.
  • Dedicated resources: RAM and vCPU are reserved for your applications.
  • Deploy in seconds: upload a zip or push via CLI and your application is running.

​
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
A web process must listen on host 0.0.0.0 and on the port in PORT (80). 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:
Then restart the application: it reads environment variables when it starts. See Environment variables.
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. For the DNS records, see how to set up your own domain in the help center.

​
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.
  • An active plan is required. Every application runs on one. 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.

​
Next steps

Configuration file

Every field of the file that replaces your Procfile.

Environment variables

Move your Config Vars and keep secrets out of your code.

Managed database

Create the database that replaces Heroku Postgres.

​
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.