Image & Video APIs

Get started with the CLI (video tutorial)

Last updated: Aug-25-2025

Overview

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!
Use the controls to set the playback speed, navigate to chapters of interest and select subtitles in your preferred language.

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 https://www.python.org. 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...

 

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: