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, you can use the fal deploy command.

Terminal window
fal deploy

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