Programmable Media

Get started with the CLI (video tutorial)

Last updated: May-08-2024


Watch this tutorial to learn how to install and configure the Cloudinary CLI.

Video tutorial

This video is brought to you by Cloudinary's video player - embed your own!

Tutorial contents

This tutorial presents the following topics. Click a timestamp to jump to that part of the video.

Check if Python is installed

Jump to this spot in the video  0:06 To use the Cloudinary CLI, you need Python 3.6 or later. You can install Python from The Python Package Installer (pip) is installed with it.

Install the Cloudinary CLI package

Jump to this spot in the video  0:10 To install the Cloudinary CLI, run:
pip3 install cloudinary-cli

Set up your environment variable

Jump to this spot in the video  0:25 To make all your cld commands point to your Cloudinary product environment, set up your CLOUDINARY_URL environment variable. Obtain your environment variable from the API Keys page of the Cloudinary Console Settings.
  • On Mac or Linux:
    export CLOUDINARY_URL=cloudinary://123456789012345:abcdefghijklmnopqrstuvwxyzA@cloud_name
  • On Windows:
    set CLOUDINARY_URL=cloudinary://123456789012345:abcdefghijklmnopqrstuvwxyzA@cloud_name

Check the configuration

Jump to this spot in the video  0:54 To check the configuration, run:
cld config

Run the help command

Jump to this spot in the video  1:04 For a list of commands, enter:
cld --help

Run the admin command

Jump to this spot in the video  1:09 To see the available Admin API methods, enter:
cld admin

Run the uploader command

Jump to this spot in the video  1:22 To see the available upload API methods, enter:
cld uploader

Run the search command

Jump to this spot in the video  1:31 To show the usage for the search API, enter:
cld search --help

Upload a video

Jump to this spot in the video  1:40 Upload the video, CLI_setup.mp4, setting the public ID and folder options:
cld uploader upload CLI_setup.mp4 public_id=setup folder=cli_video

Watch the uploaded video

Jump to this spot in the video  2:11 Use the url command to open a video in a browser:
cld url -rt video -o cli_video/setup

Keep learning

Related topics

If you like this, you might also like...

Scripting with the CLI
Use a script to create an animated GIF
Get Creative with the CLI
Create an image sprite from pages of a PDF
Upload with the CLI
Apply background removal to images on upload


Cloudinary Academy


Check out the Cloudinary Academy for free self-paced Cloudinary courses on a variety of developer or DAM topics, or register for formal instructor-led courses, either virtual or on-site.


✔️ Feedback sent!

Rate this page: