Function _run

reflex/reflex.py:262–376

Run the app in the given directory.

(
    *,
    env: constants.Env = constants.Env.DEV,
    running_mode: constants.RunningMode = constants.RunningMode.FULLSTACK,
    frontend_port: int | None = None,
    backend_port: int | None = None,
    backend_host: str | None = None,
)

def _run(
    *,
    env: constants.Env = constants.Env.DEV,
    running_mode: constants.RunningMode = constants.RunningMode.FULLSTACK,
    frontend_port: int | None = None,
    backend_port: int | None = None,
    backend_host: str | None = None,
):
    """Run the app in the given directory."""
    from reflex.istate.manager import reset_disk_state_manager
    from reflex.utils import exec, prerequisites, processes

    if frontend_port and not running_mode.has_frontend():
        console.error("Cannot specify --frontend-port when not running frontend.")
        raise SystemExit(1)
    if backend_port and not running_mode.has_backend():
        console.error("Cannot specify --backend-port when not running backend.")
        raise SystemExit(1)
    if (
        env == constants.Env.PROD
        and frontend_port
        and backend_port
        and frontend_port != backend_port
    ):
        console.error("In production, frontend and backend must run on the same port.")
        raise SystemExit(1)

    config = get_config()

    backend_host = backend_host or config.backend_host

    # Set env mode in the environment
    environment.REFLEX_ENV_MODE.set(env)

    # Show system info
    exec.output_system_info()

    if running_mode == constants.RunningMode.BACKEND_ONLY:
        _skip_compile()

    prerequisites.assert_in_reflex_dir()

    # Check that the app is initialized.
    if running_mode.has_frontend() and prerequisites.needs_reinit():
        _init(name=config.app_name)

    # Delete the states folder if it exists.
    reset_disk_state_manager()

    # Apply the new ports and host to the config.
    if frontend_port != config.frontend_port:
        config._set_persistent(frontend_port=frontend_port)
    if backend_port != config.backend_port:
        config._set_persistent(backend_port=backend_port)
    if backend_host != config.backend_host:
        config._set_persistent(backend_host=backend_host)

    # Reload the config to make sure the env vars are persistent.