Profiles

Managing Profiles

The fal CLI allows you to manage multiple profiles, making it easy to switch between different fal accounts. This is particularly useful if you have multiple environments or projects.

Adding a New Profile

To add a new profile, set it as the default and then add the key:

❯ fal profile set example
Default profile set to example.
No key set for profile. Use fal profile key to set a key.

❯ fal profile key
Enter the key: invalid
Invalid key. The key must be in the format key:value.
Enter the key: 112f05b4-6ee8-4d06-bdb1-7ba38789ef8e:954285993fa8e651dac37a03ea2efbc9
Key set for profile example.

Note: The key used in the example above is no longer valid. 😉

Listing Profiles

To list all available profiles, use the fal profile list command:

❯ fal profile list
┏━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━┓
┃ Default ┃ Profile ┃ Settings ┃
┡━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━┩
│         │ me      │ key      │
│         │ comfy   │ key      │
│ *       │ example │ key      │
└─────────┴─────────┴──────────┘

Setting a Default Profile

To set a default profile, use the fal profile set command followed by the profile name:

❯ fal profile set comfy
Default profile set to comfy.

❯ fal profile list
┏━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━┓
┃ Default ┃ Profile ┃ Settings ┃
┡━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━┩
│         │ me      │ key      │
│ *       │ comfy   │ key      │
│         │ example │ key      │
└─────────┴─────────┴──────────┘

After setting the default profile, you can directly access the account information without specifying the profile name.

❯ fal app list
┏━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┓
┃ Name   ┃ Revision           ┃ Auth   ┃ Min Concurrency ┃ Max Concurrency ┃ Max Multiplexing ┃ Keep Alive ┃ Request Timeout ┃ Startup Timeout ┃ Machine Type ┃ Runners ┃ Regions ┃
┡━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━┩
│ my-app │ 11111111-2222-333… │ shared │ 0               │ 10              │ 1                │ 300        │ 3600            │ 600             │ ........     │ 0       │         │
└────────┴────────────────────┴────────┴─────────────────┴─────────────────┴──────────────────┴────────────┴─────────────────┴─────────────────┴──────────────┴─────────┴─────────┘

Deleting a Profile

To delete a profile, use the fal profile delete command followed by the profile name:

❯ fal profile delete example
Profile example deleted.