Langflow CLI

The Langflow command line interface (Langflow CLI) is the main interface for managing and running the Langflow server.

CLI commands

The following sections describe the available CLI commands and their options, as well as their corresponding environment variables.

langflow

Running the CLI without any arguments displays a list of available options and commands.

_10

langflow [OPTIONS]

_10

# or

_10

python -m langflow [OPTIONS]

Options

Option	Default	Values	Description
--install-completion	Not applicable	Not applicable	Install auto-completion for the current shell.
--show-completion	Not applicable	Not applicable	Show the location of the auto-completion config file (if installed).
--help	Not applicable	Not applicable	Display information about the command usage and its options and arguments.

langflow api-key

Create an API key for the default superuser if the [LANGFLOW_AUTO_LOGIN environment variable] is set to true.

_10

langflow api-key [OPTIONS]

_10

# or

_10

python -m langflow api-key [OPTIONS]

Options

Option	Default	Values	Description
--log-level	critical	debug info warning error critical	Set the logging level.
--help	Not applicable	Not applicable	Display information about the command usage and its options and arguments.

langflow copy-db

Copy the database files to the current directory. Copy the Langflow database files, langflow.db and langflow-pre.db (if they exist), from the cache directory to the current directory.

note

The current directory is the directory containing __main__.py. You can find this directory by running which langflow.

_10

langflow copy-db

_10

# or

_10

python -m langflow copy-db

Options

Option	Default	Values	Description
--help	Not applicable	Not applicable	Display information about the command usage and its options and arguments.

langflow migration

Run or test database migrations.

_10

langflow migration [OPTIONS]

_10

# or

_10

python -m langflow migration [OPTIONS]

Options

Option	Default	Values	Description
--test	true	Boolean	Run migrations in test mode. Use --no-test to disable test mode.
--fix	false (--no-fix)	Boolean	Fix migrations. This is a destructive operation, and all affected data will be deleted. Only use this option if you know what you are doing.
--help	Not applicable	Not applicable	Display information about the command usage and its options and arguments.

langflow run

Start the Langflow server.

_10

langflow run [OPTIONS]

_10

# or

_10

python -m langflow run [OPTIONS]

Options

Option	Default	Values	Description
--host	127.0.0.1	String	The host on which the Langflow server will run. See LANGFLOW_HOST variable.
--workers	1	Integer	Number of worker processes. See LANGFLOW_WORKERS variable.
--worker-timeout	300	Integer	Worker timeout in seconds. See LANGFLOW_WORKER_TIMEOUT variable.
--port	7860	Integer	The port on which the Langflow server will run. The server automatically selects a free port if the specified port is in use. See LANGFLOW_PORT variable.
--components-path	langflow/components	String	Path to the directory containing custom components. See LANGFLOW_COMPONENTS_PATH variable.
--env-file	Not set	String	Path to the .env file containing environment variables. See Import environment variables from a .env file.
--log-level	critical	debug info warning error critical	Set the logging level. See LANGFLOW_LOG_LEVEL variable.
--log-file	logs/langflow.log	String	Set the path to the log file for Langflow. See LANGFLOW_LOG_FILE variable.
--cache	InMemoryCache	InMemoryCache SQLiteCache	Type of cache to use. See LANGFLOW_LANGCHAIN_CACHE variable.
--dev	false (--no-dev)	Boolean	Run Langflow in development mode (may contain bugs). See LANGFLOW_DEV variable.
--frontend-path	./frontend	String	Path to the frontend directory containing build files. This is for development purposes only. See LANGFLOW_FRONTEND_PATH variable.
--open-browser	true	Boolean	Open the system web browser on startup. Use --no-open-browser to disable opening the system web browser on startup. See LANGFLOW_OPEN_BROWSER variable.
--remove-api-keys	false (--no-remove-api-keys)	Boolean	Remove API keys from the projects saved in the database. See LANGFLOW_REMOVE_API_KEYS variable.
--backend-only	false (--no-backend-only)	Boolean	Only run Langflow's backend server (no frontend). See LANGFLOW_BACKEND_ONLY variable.
--store	true	Boolean	Enable the Langflow Store features. Use --no-store to disable the Langflow Store features. See LANGFLOW_STORE variable.
--auto-saving	true	Boolean	Enable flow auto-saving. Use --no-auto-saving to disable flow auto-saving. See LANGFLOW_AUTO_SAVING variable.
--auto-saving-interval	1000	Integer	Set the interval for flow auto-saving in milliseconds. See LANGFLOW_AUTO_SAVING_INTERVAL variable.
--health-check-max-retries	5	Integer	Set the maximum number of retries for the health check. Use --no-health-check-max-retries to disable the maximum number of retries for the health check. See LANGFLOW_HEALTH_CHECK_MAX_RETRIES variable.
--max-file-size-upload	100	Integer	Set the maximum file size for the upload in megabytes. See LANGFLOW_MAX_FILE_SIZE_UPLOAD variable.
--help	Not applicable	Not applicable	Display information about the command usage and its options and arguments.

langflow superuser

Create a superuser account.

_10

langflow superuser [OPTIONS]

_10

# or

_10

python -m langflow superuser [OPTIONS]

Options

Option	Default	Values	Description
--username	Required	String	Specify the name for the superuser. See LANGFLOW_SUPERUSER variable.
--password	Required	String	Specify the password for the superuser. See LANGFLOW_SUPERUSER_PASSWORD variable.
--log-level	critical	debug info warning error critical	Set the logging level.

Precedence

Langflow CLI options override the values of corresponding environment variables.

For example, if you have LANGFLOW_PORT=7860 defined as an environment variable, but you run the CLI with --port 7880, then Langflow will set the port to 7880 (the value passed with the CLI).

Assign values

There are two ways you can assign a value to a CLI option. You can write the option flag and its value with a single space between them: --option value. Or, you can write them using an equals sign (=) between the option flag and the value: --option=value.

Values that contain spaces must be surrounded by quotation marks: --option 'Value with Spaces' or --option='Value with Spaces'.

Boolean values

Boolean options turn a behavior on or off, and therefore accept no arguments. To activate a boolean option, type it on the command line. For example:

_10

langflow run --remove-api-keys

All boolean options have a corresponding option that negates it. For example, the negating option for --remove-api-keys is --no-remove-api-keys. These options let you negate boolean options that you may have set using environment variables.