Modifying the BaseURL in Formance CloudPrem I Setup

Last updated: September 4, 2025

Overview

In certain cases, you may need to adjust the baseUrl of your Formance CloudPrem I setup. For example, to resolve certificate limitations, you may want to change your base URL from:

https://formance.dev.company.com

to

https://dev.company.com

so that your stack URLs follow the format:

https://orgID-stackID.dev.company.com

This is fully supported and configurable.

How the BaseURL Works

  • The baseUrl is configured in the regions chart.

  • It is defined by the Helm value:

.Values.agent.baseUrl

  • This value is sent to membership on agent startup.

  • Updating this value ensures that all services and stack URLs use the correct domain.

Steps to Modify the BaseURL

  1. Locate your Helm chart values file used for the region deployment.

  2. Update the baseUrl field under the agent configuration. Example:

agent:
  baseUrl: "https://dev.company.com"

  1. Apply the changes by upgrading your Helm release:

helm upgrade <release-name> <chart-path> -f values.yaml

  1. Restart the agent (if not automatically restarted) so it registers the updated baseUrl with membership.

Verification

After deployment:

  1. Confirm the agent logs show the updated baseUrl.

  2. Verify your stack URLs are available in the new format:

https://orgID-stackID.dev.company.com

  1. Ensure TLS certificates cover the new domain (*.dev.company.com).

  • The baseUrl can be updated at any time, but ensure DNS and certificates are properly configured before rollout.

  • If migrating from one domain to another, validate that no services or external integrations depend on the old domain.