Skip to main content

Quick Start

Getting started with Fractal Cloud is straightforward. We fully support Azure, GCP and AWS for all users.

Enterprise Customers

Integration with Oracle Cloud Infrastructure (OCI) and Hetzner is currently available for enterprise customers only.

Follow these steps to connect your cloud environment with Fractal Cloud and begin creating cloud infrastructure.

Prerequisites​

  • An active Azure, GCP or AWS Subscription with billing enabled.
  • Log in or Register a Fractal Cloud account.

Setup Process​

1. Create a Resource Group​

Begin by creating a Resource Group in Fractal Cloud. This group will organize all the resources required for your Fractals and LiveSystems.

2. Create an Environment​

Next, create an environment within Fractal Cloud. This environment acts as a workspace for your LiveSystems and Fractals, allowing you to manage your resources effectively.

3. Initialize the Cloud Agent​

Initialize the Fractal Cloud Agent in your Azure environment. This step sets up the necessary resources and generates crucial credentials for integration.

For detailed instructions, see the Fractal Cloud Environment Initialization Guide.

4. Create and Instantiate Your First Fractal​

With your environment and resource group ready, you can now create your first Fractal and instantiate it. This step brings your cloud infrastructure components to life.

5. SDK Usage​

To provision infrastructure components programmatically, you can use our SDKs. For authentication, you'll need to retrieve specific secrets essential for authenticating your SDK-based applications with Fractal Cloud.

Retrieving your CI/CD credentials

Your CI/CD service account's Client Id and Client Secret are available directly in the Fractal Cloud UI, on the environment your SDK application deploys to. Copy them from there and supply them to your application or pipeline as you would any other credential.

This is identical for every cloud provider, so your SDK setup does not change between Azure, GCP, AWS, and OCI or Hetzner enterprise environments.

Looking for these in your own cloud secret store?

Earlier versions of Fractal Cloud also copied this credential into your own cloud secret store — Azure Key Vault, AWS Secrets Manager, GCP Secret Manager, OCI Vault or Hetzner Secret Manager — as fractal-ci-cd-service-account-name and fractal-ci-cd-service-account-password.

That copy is no longer written, and it is removed from environments that still hold one the next time their Cloud Agent is updated. Use the UI instead: it is the single authoritative source, so it cannot fall out of step with the credential the platform actually accepts. Nothing is lost in the change — the service account itself is untouched.

Our SDK packages are publicly available. You can find the SDKs and sample repositories on GitHub:

Explore the SDKs for detailed documentation and the samples for practical usage examples to get started with provisioning and managing your cloud infrastructure components efficiently.

Congratulations 🎉!

You've set up the basics. Now, you're ready to explore Fractal Cloud's features and start building amazing applications.

If you have any questions or need further assistance, please contact us.