Skip to main content
Please ensure the following packages are installed:And you’ve completed the previous steps:

1. Create an Organisation

Open your terminal (e.g. VSCode or iTerm2) and at the root of your project run the following:
fjall organisation create

2. Follow the CLI Prompts

Provide the required inputs:
  • Organisation Name – Name of your organisation
  • Account Name (Optional) – Root AWS account name (if different from org name)
  • AWS Email – Email tied to your AWS root account (e.g. [email protected])
  • Primary Region – Your default region for Identity Center and IPAM Pools
  • Secondary Regions – Additional AWS regions for deployment
  • AccessKey – From the Initial Setup: IAM User
  • Secret AccessKey – From the same setup step as above
Organisation CLI prompts Figure: Creating your organisation via Fjall CLI.

3. Configure Infrastructure File

Update the generated infrastructure file at:
fjall/organisation/infrastructure.ts
📝 By default, Fjall will generate five accounts: Production, Staging, Development, Platform, and Business Continuity. These are mapped to their respective organisational units.
Fjall Infrastructure Config Figure: Update your generated infrastructure config.

4. Deploy Your Organisation

Deploy the managed organisation using Fjall CLI.
Ensure you’re using the correct AWS profile (e.g. fjall).
fjall organisation deploy

✅ Success Example

A successful deployment will produce output similar to:
--- Deployment Summary ---

🎉 Success! Your AWS organisation has been deployed.

🔗 You can now deploy your platform account with 'fjall organisation deploy --platform'!

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

Next Steps

You’re now ready to Deploy Your Platform Account! ✅