> ## 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 using your corporate SSO identity

Before you start, make sure `difyctl` is [installed](/en/3.11.x/develop/cli/install).

## Step 1: Sign In

Run the login command with the host URL your administrator gave you:

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

`difyctl` prints a one-time code and a verification URL, opens the URL in your default browser, and waits:

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

The browser walks you through your company's usual sign-in flow, then asks for the one-time code. Once you complete it, the terminal confirms:

```text theme={null}
✓ Logged in to dify.example.com as <your-email> (external SSO, issuer: <your-identity-provider>)
```

## Step 2: See the Apps You Can Run

List the apps your administrator permitted you to use:

```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.

## Step 3: Run Your App

How you pass input depends on the app type.

<Tabs>
  <Tab title="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>

  <Tab title="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"]}
    ```
  </Tab>
</Tabs>

## Next Steps

* **The everyday commands, copy-paste ready**: [Common Tasks](/en/3.11.x/develop/cli/sso-users/common-tasks)
* **What your session can and can't do**: [Scope and Limitations](/en/3.11.x/develop/cli/sso-users/scope-and-limitations)