Fjall Docs — Deploy Production-Ready AWS Infrastructure in Minutes

Prerequisites

1. Select the deployment target

In organisation mode, the active deployment target decides which AWS account and region a deploy lands in. Set it before deploying:

fjall target set production-us-use1

Run without a name to pick from the list of derived targets:

fjall target set

Target names follow the format <account>-<region>, for example production-us-use1 (where use1 = us-east-1). Run fjall target list to see every available target. The active target is marked with a ▸. Targets are derived automatically from your organisation config, so there is nothing to author by hand.

In account mode (a single AWS account connected with fjall connect), authentication runs through OIDC and there is no target to select. Skip this step.

2. Deploy the platform account

Run the deploy command from the root of your project:

fjall deploy platform

platform is a standalone deployable target. It provisions shared AWS services, including ECR repositories, domains, and cross-account roles.

What happens

Step	Action
Profile resolution	Fjall resolves the AWS profile for the active target (or the `--target` override).
Synthesis	The CDK app synthesises the platform stack.
Deploy	CloudFormation provisions ECR repositories, domains, and cross-account roles.

Success example

A successful deployment prints:

--- Deployment Summary ---

🎉 Success! Your platform account has been deployed.

🔗 You can now deploy your managed accounts with 'fjall deploy account'!

   /\
  /  \ /\
 /  _ _\ _\
   Fjall

Options

Flag	Description
`--target <name>`	Override the active target for this deploy.
`--region <region>`	Deploy to a specific region.
`-e, --environment <env>`	Optional free-form CI/CD label passed to CDK synthesis. Does not select an account or region.
`--skip-migrations`	Skip database migrations during the deploy.
`-v, --verbose`	Print verbose output.

Install & Setup

Application Deploy

Organisation Setup

Organisation Deploy

Deploy Platform

Prerequisites

1. Select the deployment target

2. Deploy the platform account

What happens

Success example

Options

Next Steps

Deploy Account

Understanding Profiles

​Prerequisites

​1. Select the deployment target

​2. Deploy the platform account

​What happens

​Success example

​Options

​Next Steps

Deploy Account

Understanding Profiles

Prerequisites

1. Select the deployment target

2. Deploy the platform account

What happens

Success example

Options

Next Steps