Skip to main content
Quick overview command — Shows your infrastructure at a glance with deployment status.

​
Overview

The fjall list command displays all your organisations and applications, checking their deployment status in AWS. It helps you quickly see what’s been created locally and what’s actually deployed.

​
Usage

fjall list [type]

​
Examples

​
Interactive Mode

Run without arguments to choose what to list: 
fjall list
Prompts: 
? What would you like to list?
  ❯ Applications - Cloud applications
    Organisations - AWS foundation

​
List Organisations

fjall list organisation
Output: 
Organisations

  organisation    ✓ deployed
  platform        not deployed

​
List Applications

fjall list application
# or
fjall list app
Output: 
Applications

  app                   ✓ deployed
  api-service           not deployed
  web-frontend          ✓ deployed

​
Understanding Status

The command shows two possible statuses:
StatusDescription
✓ deployedInfrastructure is live in AWS
not deployedCreated locally but not deployed to AWS

​
How It Works

  1. Checks local files - Scans fjall/ directory for targets
  2. Validates credentials - Uses current AWS profile if available
  3. Queries AWS - Checks CloudFormation stacks for deployment status
  4. Displays results - Shows formatted list with status

​
Status Detection

For each target, Fjall checks:
  • Organisations: Looks for ManagedOrganisation stack
  • Applications: Looks for [AppName]Network stack
If AWS credentials aren’t configured, all items show as “not deployed”.

​
Common Use Cases

​
Pre-deployment Check

See what needs deploying: 
fjall list
# Then deploy what's needed
fjall deploy app

​
Post-creation Verification

After creating infrastructure: 
fjall create app --name api
fjall list app
# Shows: api    not deployed

​
Quick Status Check

# Check everything
fjall list

# Just organisations
fjall list org

# Just applications  
fjall list app

​
Tips for AWS Credentials

If you see all items as “not deployed” but know they’re deployed:
  1. Set AWS profile: 
    fjall profile set
  2. Or use environment variables: 
    export AWS_PROFILE=production
fjall list
  3. Check profile is correct: 
    fjall profile get

​
Integration with Other Commands

Use list to verify before other operations: 
# Check what exists
fjall list

# Deploy undeployed items
fjall deploy api-service

# Verify deployment
fjall list app

​
Troubleshooting

​
All Items Show “not deployed”

This usually means:
  • No AWS credentials configured
  • Wrong AWS profile active
  • Insufficient permissions to query CloudFormation
Fix: 
fjall profile set
# Select correct profile
fjall list

​
Missing Items

If expected items don’t appear:
  • Check you’re in the project root
  • Verify fjall/ directory exists
  • Ensure targets have required files
The list command requires valid AWS credentials to show accurate deployment status. Without credentials, it can only show what exists locally.