> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Run your first Dify app from the command line in under 5 minutes

Before you start, make sure `difyctl` is [installed](https://enterprise-docs.dify.ai/en/3.13.x/develop/cli/install.md).

> [!NOTE]
>
> The CLI's API endpoints (`/openapi/v1/*`) are off by default: set `api.openapi.enabled: true` in the Helm values before you sign in. `api.enableOauthBearer` must stay `true` (the default).

## Step 1: Sign In

1. Sign in to your company's Dify host. Use the [console API URL](https://enterprise-docs.dify.ai/en/3.13.x/deploy/advanced-configuration/environment-variables.md#console_api_url) for your instance.

   ```bash theme={null}
   difyctl auth login --host https://dify.example.com
   ```

   `difyctl` prints a one-time code and a verification URL, then waits:

   ```text theme={null}
   ! Copy this one-time code: WDJP-XKLM
     Open: https://dify.example.com/device
   ```

2. Open the URL in a browser, enter the code, and sign in. Return to the terminal and you'll see:

   ```text theme={null}
   ✓ Logged in to dify.example.com as <your-email> (<your-name>)
     Workspace: <your-workspace>
   ```

## Step 2: Find Your App

List the apps in your workspace:

```bash theme={null}
difyctl get app
```

You should see something like this:

```text theme={null}
NAME          ID                                    MODE      UPDATED
Customer FAQ  0a1b2c3d-4e5f-6789-abcd-ef0123456789  chat      2026-06-08T03:14:27.521839
Daily Report  7f3e9a2b-1c4d-4e8f-9a0b-2d5c8e1f4a7b  workflow  2026-06-05T22:41:09.812016
```

Copy the ID of the app you want to run. The examples below use the two IDs from this table.

## Step 3: Run Your App

How you pass input depends on the app type.

> [tab] Chatbot / Chatflow / Agent / Text Generator
>
> Pass your message as a positional argument:
>
> ```bash theme={null}
> difyctl run app 0a1b2c3d-4e5f-6789-abcd-ef0123456789 "What are your business hours?"
> ```
>
> The reply prints to stdout. For Chatbot, Chatflow, and Agent apps, a hint also prints to stderr so you can continue the same conversation later:
>
> ```text theme={null}
> Our business hours are Monday through Friday, 9am to 6pm PT.
>
> hint: continue this conversation with --conversation 4f7d8c2a-9b1e-4c6d-8a3f-5e2b7c9d0a1f
> ```

> [tab] Workflow
>
> Pass inputs as a single JSON object with `--inputs`:
>
> ```bash theme={null}
> difyctl run app 7f3e9a2b-1c4d-4e8f-9a0b-2d5c8e1f4a7b --inputs '{"topic":"quarterly report","audience":"executives"}'
> ```
>
> The workflow's outputs print to stdout as JSON:
>
> ```json theme={null}
> {"summary":"Q3 revenue grew 14% YoY...","sections":["revenue","costs","outlook"]}
> ```

## Next Steps

* **The everyday commands, copy-paste ready**: [Common Tasks](https://enterprise-docs.dify.ai/en/3.13.x/develop/cli/account-users/common-tasks.md)
* **Where your token lives and how sessions work**: [Authenticate](https://enterprise-docs.dify.ai/en/3.13.x/develop/cli/account-users/authenticate.md)
* **Everything else you can do with `difyctl`**: [Command Index](https://enterprise-docs.dify.ai/en/3.13.x/develop/cli/reference/command-index.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.