_Docs/
Get StartedModulesPlatformDeployCookbookChangelogReference
_Deploy
  • Deployment Overview
    • Overview
    • Requirements
    • Demo
      • All-in-one Demo Chart
    • Installation
      • Operator Setup
      • Control Plane SetupEE
    • Infrastructure Services
      • PostgreSQL
      • Message Broker
      • Temporal
    • Module Configuration
      • Stack Configuration
      • Gateway Module
      • Ledger Module
      • Payments Module
      • Auth ModuleEE
      • Orchestration ModuleEE
      • Reconciliation ModuleEE
      • Wallets ModuleEE
      • Webhooks ModuleEE
    • Configuration Reference
      • Operator settings reference
      • API Reference
    • Backups management
    • Troubleshooting
    • Configure OpenTelemetry
    • Traces
    • Metrics
    • Upgrade from the operator
    • Database update
  1. Deploy
  2. Cloud
  3. Overview
Deploy

Overview

Formance Cloud is a fully hosted and managed deployment environment which can be used for your production applications. Information regarding the available plans can be found on the Formance Cloud Pricing page.

Available Regions#

Formance Cloud is available in the following regions:

NameRegionAvailability
aws-us-west-2-hostingUS, Oregon (AWS)General Availability
aws-us-east-1-hostingUS, Virginia (AWS)General Availability
aws-eu-west-1-hostingEU, Ireland (AWS)General Availability
aws-ap-southeast-1-hostingAPAC, Singapore (AWS)Available upon request

Getting Started#

Prerequisites#

Before creating a stack, ensure you have:

  • fctl installed
  • A Formance Cloud account

Creating a Stack#

Once you have set up a billing account (by reaching out to us), your available production deployments quota will be increased. You can then create a production deployment:

Shell
fctl stack create my-stack

To specify a region:

Shell
fctl stack create my-stack --region aws-eu-west-1-hosting

Listing Regions#

To list all available regions:

Shell
fctl cloud regions ls

To get detailed information about a specific region, including available modules:

Shell
fctl cloud regions show aws-eu-west-1-hosting

Example output:

# Information
ID        | c9abcd0df-480b-42c4-b5e7-dfght8e7c852
Name      | example
Base URL  | https://example.com
Active    | Yes
Public    | Yes
Version   | latest
Last ping | 2024-05-15T14:09:02Z

# Capabilities
MODULE_LIST | auth, gateway, ledger, orchestration, payments, reconciliation, stargate, wallets, webhooks

Managing Modules#

By default, a stack includes the following modules:

  • Ledger - Double-entry accounting
  • Gateway - API gateway
  • Payments - Payment provider integrations
  • Auth - Authentication
  • Stargate - Connectivity layer

Enable/Disable Modules#

You can enable or disable additional modules using fctl:

Shell
# Enable a module
fctl stack modules enable orchestration

# Disable a module
fctl stack modules disable orchestration

Available Modules#

The following modules can be enabled on your stack:

ModuleDescription
ledgerDouble-entry accounting system
paymentsPayment provider integrations
walletsDigital wallet management
orchestrationWorkflow orchestration (Flows)
reconciliationPayment reconciliation
webhooksEvent notifications
authAuthentication
gatewayAPI gateway
stargateConnectivity layer

Verifying Your Stack#

After creating your stack, verify it's working properly:

Shell
# Check stack status
fctl stack show my-stack

# Query ledger server info
fctl ledger server-infos --stack=my-stack

Managing Your Stack#

List Stacks#

Shell
fctl stack ls

Delete a Stack#

Shell
fctl stack delete my-stack

Information and Requests#

For more information and any requests regarding the Formance Cloud offering, please contact us at support@formance.com.

As a SOC-2 Type II certified company, we take security and privacy seriously — and will be happy to answer any questions you may have, as well as provide you with a copy of our SOC-2 report upon request.

Deployment OverviewRequirements
On This Page
  • Available Regions
  • Getting Started
  • Prerequisites
  • Creating a Stack
  • Listing Regions
  • Managing Modules
  • Enable/Disable Modules
  • Available Modules
  • Verifying Your Stack
  • Managing Your Stack
  • List Stacks
  • Delete a Stack
  • Information and Requests