Connect your cloud account
Whatever cloud you prefer is fine by us
Encore lets you deploy your application to any of the major cloud providers, using your own cloud account. This lets you use Encore to improve your experience and productivity, while keeping the reliability of a major cloud provider.
Each environment can be configured to use a different cloud provider, and you can have as many environments as you wish. This also lets you easily deploy a hybrid or multi-cloud application, as you see fit.
Please note
Encore will provision infrastructure in your cloud account, but for safety reasons Encore does not destroy infrastructure once it's no longer required.
This means if you disconnect your app from your cloud provider, or delete the environment within Encore, you need to manually remove the infrastructure that was created by Encore.
Google Cloud Platform (GCP)
Encore provides a GCP Service Account for each Encore application, letting you grant Encore access to provision all the necessary infrastructure directly in your own GCP Organization account.
To find your app's Service Account email and configure GCP deployments, head over to the Connect Cloud page by going to the Encore Cloud dashboard > (Select your app) > App Settings > Integrations > Connect Cloud.
Troubleshooting
I can't access/edit the Policy for Domain restricted sharing page
To edit Organization policies, you need to have the Organization Policy Administrator role. If you don't have this role, you can ask your GCP Organization Administrator to grant you the necessary permissions.
If you're a GCP Organization Administrator, you can grant yourself the necessary permissions by following the steps below:
- Go to the IAM & Admin page in the GCP Console.
- Find your user account in the list of members.
- Click the pencil icon to edit your user account.
- Add the
Organization Policy Administratorrole to your user account. - Click Save.
I can't grant access to the Encore service account
If you're unable to grant access to the Encore service account, you may have failed to add Encore to your Domain restricted sharing policy.
Make sure you've followed all the steps in the Connect Cloud page to add Encore to the policy.
If you're using several GCP accounts, make sure you're logged in with the correct account and that the correct organization is selected in the GCP Console.
Encore returns "Could not find Organization ID"
If you see this error message, it means that Encore was unable to connect to your GCP Organization. Make sure you've followed all the steps in the Connect Cloud page to grant Encore access to your GCP Organization. If you're using several GCP accounts, make sure you're logged in with the correct account and that the correct organization is selected in the GCP Console.
Still having issues? Drop us an email at [email protected] or chat with us in the [Encore Discord](https://encore.dev/discord.
Amazon Web Services (AWS)
To configure your Encore app to deploy to your AWS account, head over to the Connect Cloud page by going to the Encore Cloud dashboard > (Select your app) > App Settings > Integrations > Connect Cloud.
Follow the instructions to create an IAM Role, and then connect the role with Encore. Learn more in the AWS docs.
Look out!
For your security, make sure to check Require external ID and specify the
external ID provided in the instructions.
After connecting your app to AWS, you will be asked to choose which region you want Encore to provision resources in. Learn more about AWS regions here.