Skip to main content

​
Setting Secrets

For setting sensitive information (such as API keys or database credentials) to be accessed within your fal functions you can use the fal secrets CLI interface. 
$ fal secrets set MY_API_TOKEN=token MY_IDENTITY_KEY=identity
Any secret that is set will be exposed to all functions running from your user, and can be accessible as if they are regular environment variables.

​
Accessing Secrets in Your Code

import os
import fal

class MyApp(fal.App):
    @fal.endpoint("/")
    def print_secrets(self):
        print(os.getenv("MY_API_TOKEN"))
        print(os.getenv("MY_IDENTITY_KEY"))
        return {"status": "secrets printed"}

​
Accessing Secrets in Your Requirements

For security reasons, we don’t expose your secrets as environment variables during the environment building stage. Instead, you can use ${} to substitute your secret into a requirement. 
import fal

class MyApp(fal.App):
    requirements = [
        "git+https://${GITHUB_TOKEN}@github.com/myorg/myproj"
    ]

​
Listing Secrets

You can list the secrets you have through the CLI, but the values will be hidden for security reasons. 
$ fal secrets list
Secret NameCreated At
MY_API_TOKEN2023-09-05 15:17:39.279347
MY_IDENTITY_KEY2023-09-05 15:17:41.444478

​
Removing Secrets

To omit a secret from being present in new runs, you can simply delete it through the CLI: 
$ fal secrets unset MY_API_TOKEN