fal apps rollout

Usage: fal apps rollout [-h] [--debug] [--pdb] [--cprofile] [--team TEAM] 
                        [--force] [--env ENV] app_name

Rollout application by restarting all active runners.

Positional Arguments:
  app_name     Application name.

Options:
  -h, --help   show this help message and exit
  --team TEAM  The team to use.
  --force      Force rollout by killing runners immediately instead of 
               gracefully stopping them.
  --env ENV    Target environment (defaults to main).

Debug:
  --debug      Show verbose errors.
  --pdb        Start pdb on error.
  --cprofile   Show cProfile report.

​

When to Use

• Environment variable changes: Force runners to pick up updated secrets or environment variables
• Bad state recovery: Replace runners that may be in an unhealthy state
• Memory cleanup: Force garbage collection and memory cleanup across all runners
• Configuration updates: Apply changes that require a fresh runner
• Machine type changes: Move existing runners onto a machine type you changed with fal apps scale — see Changing Machine Types

​

Graceful vs Force Rollout

​

Graceful Rollout (Default)

fal apps rollout myapp

1. Identifies all active runners for the application
2. Marks each one for replacement — they keep serving requests in the meantime
3. Starts replacement runners on the application’s current configuration
4. As each new runner finishes starting up and joins the application, one marked runner stops accepting new requests and drains the ones it is still processing

​

Force Rollout

fal apps rollout myapp --force

1. Identifies all active runners for the application
2. Immediately terminates all runners
3. New runners are automatically started by the auto-scaling system

​

Examples

​

Rollout after updating a secret

# Update a secret
fal secrets set MY_API_KEY new_value

# Gracefully rollout to pick up the new secret
fal apps rollout myapp

​

Rollout in a specific environment

# Update a secret in staging
fal secrets set MY_API_KEY staging_value --env staging

# Rollout the staging environment
fal apps rollout myapp --env staging

​

Force rollout to recover from frozen runners

# Check runners status
fal apps runners myapp

# Force immediate restart if runners are unresponsive
fal apps rollout myapp --force

​

Difference from Redeployment

• fal apps rollout: Replaces existing runners without creating a new revision, so they come up on the app’s current configuration. Useful for applying environment or machine-type changes and recovering from bad states.
• fal deploy: Creates a new revision of your application with updated code and configuration. Use this when you’ve made code changes.

​

See Also

• fal deploy - Deploy a new revision of your application
• fal apps scale - Adjust scaling parameters
• fal apps runners - View active runners for an application