All Products
Search
Document Center

Platform For AI:Before you begin

Last Updated:Mar 06, 2026

Download DLC client and configure authentication to manage data and jobs in Platform for AI (PAI).

Usage notes

If a certificate error occurs, run sudo apt-get update && sudo apt-get install ca-certificates to resolve it.

Download DLC client

Download DLC client for your operating system:

No installation required. Grant execute permission by running chmod +x dlc.

Auto-completion

  • Feature description

    DLC auto-completion works like kubectl and Arena commands. Type partial commands or arguments, then press Tab twice to complete them.

  • Syntax

    ./dlc completion <shelltype>
  • Parameter description

    <shelltype> specifies command type for auto-completion. Valid values: bash, fish, powershell, and zsh.

  • Examples

    Enable auto-completion for bash commands:

    1. Install bash-completion package if not already installed, then enable it with source command. Skip this step if bash-completion is installed.

      # Run the following command to install the bash-completion package in macOS:
      brew install bash-completion && source /usr/local/etc/bash_completion
      # Run the following command to install the bash-completion package in Linux:
      yum install bash-completion && source /etc/profile.d/bash_completion.sh
    2. Enable auto-completion feature. Auto-completion depends on bash-completion package. If an error occurs during execution, install bash-completion first.

      source <(./dlc completion bash)
    3. Enter ./dlc and press Tab twice to view available DLC commands.

      ./dlc 

      Available DLC commands:

      completion  config      create      delete      get         help        logs        stop        submit
    Note

    For auto-completion instructions on other shell types, run dlc completion <zsh | fish | powershell> --help.

Identity authentication

  • Feature description

    First-time DLC client usage requires authentication using your Alibaba Cloud AccessKey pair. After initial authentication, subsequent client sessions run without re-authentication.

  • Syntax

    ./dlc config --protocol https --access_id <yourAccessKeyID> --access_key <yourAccessKeySecret> [--endpoint <yourEndpoint>] [--region <yourRegion>]
  • Parameter description

    Parameter

    Required

    Description

    Type

    <yourAccessKeyId>

    Yes

    AccessKey ID of your Alibaba Cloud account.

    STRING

    <yourAccessKeySecret>

    Yes

    AccessKey secret of your Alibaba Cloud account.

    STRING

    <yourEndpoint>

    Yes

    Endpoint of the region where DLC service resides. Example: pai-dlc.cn-shanghai.aliyuncs.com.

    STRING

    <yourRegion>

    Yes

    Region where DLC service resides. For example, China (Shanghai) is cn-shanghai.

    STRING

  • Examples

    After completing authentication, system saves configuration to .dlc/config file in current directory by default. Example authentication command:

    ./dlc config --protocol https       \
               --access_id <AccessKeyId>       \
               --access_key <AccessKeySecret>  \
               --endpoint 'pai-dlc.cn-shanghai.aliyuncs.com' \
               --region cn-shanghai

    Expected output:

    [OK] Configuration saved to: ~/.dlc/config

References

  • After completing authentication, refer to supported commands list for available operations. For more information, see Command list.

  • DLC jobs can also be submitted in PAI console. For more information, see Submit jobs by using the console.