> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fjall.io/llms.txt
> Use this file to discover all available pages before exploring further.

# fjall import

> Import existing AWS resources into a Fjall application managed by CloudFormation. This command is planned and not yet available.

<Warning>
  **`fjall import` is not yet available.** The command is registered but does not work end to end. Do not rely on it to adopt production resources. Track existing AWS resources manually until import ships. This page describes the planned behaviour.
</Warning>

## Overview

When it ships, `fjall import` will adopt an existing AWS resource into a Fjall application. It will read the resource configuration from the AWS API, generate the matching CDK code in `infrastructure.ts`, and run the CloudFormation import so the resource is managed by Fjall without being recreated.

## Until import ships

To bring an existing resource under Fjall management today:

* Declare the resource in `infrastructure.ts` with [`fjall add`](/cli/add) and let the next deploy create the managed equivalent.
* Track resources you cannot yet adopt in your own notes, and reconcile them once import is available.

For restoring data from a snapshot or recovery point, see [`fjall restore`](/cli/restore).

## Planned interface

The interface below is the intended shape and may change before release.

```bash theme={null}
fjall import --app <name> [options]
```

| Option                       | Description                                        |
| ---------------------------- | -------------------------------------------------- |
| `-a, --app <name>`           | Target application (required)                      |
| `-t, --resource-type <type>` | Resource type to discover                          |
| `-n, --resource-name <name>` | Name for the imported resource                     |
| `--resource-id <id>`         | Physical resource ID to import                     |
| `--discovery-mode <mode>`    | `automatic` (default) or `manual`                  |
| `--region <region>`          | AWS region to search                               |
| `--yes`                      | Skip the dry run and apply the import (agent mode) |
| `-v, --verbose`              | Show detailed output                               |
| `--non-interactive`          | Disable prompts                                    |

Agent flags also apply: `--agent`, `--budget <level>`, `--fields <fields>`, `--full`.

## Next Steps

<CardGroup cols={2}>
  <Card title="fjall add" icon="plus" href="/cli/add">
    Declare a resource in your application's infrastructure today.
  </Card>

  <Card title="fjall restore" icon="clock-rotate-left" href="/cli/restore">
    Restore data from a snapshot or recovery point.
  </Card>

  <Card title="fjall deploy" icon="rocket" href="/cli/deploy">
    Deploy infrastructure changes to AWS.
  </Card>

  <Card title="fjall connect" icon="aws" href="/cli/connect">
    Connect the AWS account that holds the resource.
  </Card>
</CardGroup>