Multi-region feature
Learn how to deploy your monday code app to multiple data regions.
monday.com and monday code data centers are located in three different regions: US (United States), EU (Europe), and AU (Australia). Using the multi-region feature, public monday code apps can be deployed to all regions!
Doing so ensures that customer data won't leave its region, helps apps maintain compliance with region-specific regulations (e.g., GDPR), and reduces latency, all while eliminating the need for complex infrastructure setups across multiple jurisdictions.
Eligibility
The multi-region feature is available for public monday code apps. If you have a private app, new deployments will default to the region assigned to your account. You can check which region you are in using these steps:
- Open your monday account and click your profile picture in the top-right corner.
- Select Administration.
- You will see the region listed under General > Profile.
How it works
For developers
App deployment regions will vary based on whether or not the multi-region feature is enabled. The table below explains the behavior for app developers:
Multi-region feature | Region |
---|---|
Disabled | The region the developer's account is in |
Enabled | US, EU, AU (after individual deployments) |
Note for early adopters and private app developers
Your app will be hosted on US servers if you deployed it before multi-region support (mid-August 2024). If you want to serve your app from another region, enable multi-region and deploy it to your region of choice.
End users
End users will get the app version that is most relevant based on their region. The table below explains the behavior for end users:
Multi-region feature | Region |
---|---|
Disabled | The region the developer deploys to |
Enabled | The region customer's account is in |
Use the feature
To use the multi-region feature, you must first enable it and then individually deploy your app to all 3 regions. Once enabled, the feature only impacts new app deployments.
You need to repeat the process for each app if you have more than one. If you don't deploy to each region individually, you won't be able to promote your version to live.
Once you enable the multi-region feature for an app, you cannot disable it after promoting the app to live.
Step 1: Create or open a draft version
The feature can only be enabled in a draft version, so create a new one or open an existing one!
Step 2: Enable multi-region support
- Open the General monday code tab in the Developer Center.
- Click Enable multi-region support.
- You will now see all three regions listed.
Having issues enabling the feature?
If you're having issues enabling the multi-region feature, ensure your app:
- is public (via the Share tab in the leftpane)
- has at least one deployment to monday code
Step 3: Connect your app to monday code in each region
- Install the CLI beta version:
npm install @mondaycom/[email protected]
- In the General tab, click Connect to monday code for either Europe or Australia.
- Deploy your app using the region flag:
Long flag | Short flag | Description | Accepted values |
---|---|---|---|
--region | -z | The region to deploy to | eu , us , `au |
- Repeat the process for each region.
mapps code:push -i 1234567 -z au
Step 4: Set your environment variables and secrets
Environment variables and secrets should be configured for each region. Please note that alert policies are configured on the global level.
Existing environment variables and secrets
- Click Edit variable or Edit secret.
- Enter the value for all three regions.
- Click Save.
New environment variables and secrets
- Click Add new variable or Add new secret.
- Enter the value for all three regions.
- Click Save.
Step 5: Publish a new version
Once your app is ready to go, you can promote your draft version to live!
Note: After promoting your app, you cannot disable the multi-region feature.
Updated 2 months ago