Skip to content
fal.ai Docs

Deployment

Ephemeral Deployments

Ephemeral deployments are a feature of fal that allows you to deploy your application to a temporary URL. This is useful for testing and development.

Terminal window
fal run MyApp::path/to/myapp.py
...
==> Setting up runtime
2025-03-17 12:30:52.292 [info     ] Starting runner 70413bcd-5bb6-40fd-b711-b8b7ef3fc8a0
2025-03-17 12:30:55.367 [info     ] Opening connection to runner
2025-03-17 12:30:55.858 [info     ] Access your exposed service at https://fal.run/myuser/2577e7b3-88d9-49f8-a1e6-4c226e19922f
2025-03-17 12:30:55.859 [info     ] Access the playground at https://fal.ai/dashboard/sdk/myuser/2577e7b3-88d9-49f8-a1e6-4c226e19922f
==> Running
INFO:     Started server process [38]
INFO:     Waiting for application startup.
INFO:     Started server process [38]
INFO:     Waiting for application startup.
...

When running fal run, you will see two URLs that look like this:

  • https://fal.run/myuser/2577e7b3-88d9-49f8-a1e6-4c226e19922f - This is the URL for a REST API of your application, that you can use to make requests to.
  • https://fal.ai/dashboard/sdk/myuser/2577e7b3-88d9-49f8-a1e6-4c226e19922f - This is the URL of the friendly WebUI playground that we generate for your application.

Once you kill the fal run process in your terminal, the ephemeral deployment will be destroyed.

Deploying

To permanently deploy your application or update/redeploy existing one, you can use the fal deploy command.

Terminal window
fal deploy

Deployment Authentication Mode

Your app could be deployed in one of three authentication modes:

  • private: default, your app is visible only to you and/or your team.
  • shared: everyone can see and use your app, the user pays for it. This is how all of the apps in our Model Gallery work.
  • public: everyone can see and use your app, the app owner (you) is paying for it.

Use fal deploy’s --auth flag or fal.App’s app_auth to specify your app’s authentication mode, e.g.

class MyApp(fal.App):
    auth_mode = "shared"
Terminal window
fal deploy --auth shared

To change the mode just redeploy the app.

Listing Deployed Applications

To list all deployed applications, you can use the fal apps list command.

Terminal window
fal apps list

Deleting an app

To delete an app, you can use the fal apps delete command.

Terminal window
fal apps delete myapp