Dropbox Command Line

Posted onby admin

A command line tool for Dropbox users and team admins

Dropbox Headless Install via command line. The Dropbox daemon works fine on all 32-bit and 64-bit Linux servers. To install, run the following command in your Linux terminal. Dec 25, 2012 Command Line For Dropbox Cloud to Login, Upload, Delete Files is possible using cURL, grep, tr, sed as well as using scripts written in ruby, php or bash script. By default these will work on Linux or Mac OS X not for Windows. For Windows you need to install the components. CURL, grep, tr, sed are normal standard UNIX commands. Dec 02, 2018 dropbox-uploader.sh is a BASH script (found here) that lets you interact with Dropbox from the command line. It uses an application api and therefore you do not need to supply a username / password when using the script.

DBXCLI is a command line client for Dropbox built using the Go SDK. With it you can upload files, download files, automate Dropbox backups, and much more!


  • Supports basic file operations like ls, cp, mkdir, mv (via the Files API)
  • Supports search
  • Supports file revisions and file restore
  • Chunked uploads for large files, paginated listing for large directories
  • Supports a growing set of Team operations


Download pre-compiled binaries for Mac, Windows and Linux from the releases page: https://github.com/dropbox/dbxcli/releases.

DBXCLI is portable, which means that to install all you have to do is download and execute. But it is preferable to have the binary on your path this way you can call it from any directory.

For the Mac the instructions to do just that are below.

  1. Make sure you download and place the binary in a folder that's on your $PATH. If you have such directory reserved for such purpose skip to step 3.

  2. Create a bin directory under your home directory.

Add the following line at the end of your ~/.bash_profile file.

  1. Download the dbxcli binary for OSX and rename it.
  1. Finally, make the binary an executable file and you are good to go!

That's it! DBXCLI should be now ready to get to work.


dbxcli is largely self documenting. Run dbxcli -h for a list of supported commands:

The --verbose option will turn on verbose logging and is useful for debugging.

Quick Start

Dropbox Command Line Download

First we have to add an account to dbxcli. To do that execute:

The program will output a link, just copy and paste that link into your browser's address bar. DBXCLI works with Dropbox API so you need to authorize it to work in your Dropbox folder. After logging into Dropbox click the Allow buttom.

Once you click in the Allow button Dropbox's site will display a key of alpha-numeric characters. Copy it and paste into the terminal:

After that you are ready to use it.

For instance to copy the local file ~/Document.docx to a folder called Docs inside your Dropbox do:

To download files use get. Like this:


In order to automate these tasks you need to use some sort of task scheduler program. Fortunately all major OSs comes with one already.

For Macs and Linuxes use the cron. For Windows, you can use Task Scheduler.

Dropbox Command Line Linux

Also note that for regular Dropbox account you can have up to 30 days of file revisions. Which means with you overwrite the same backup file over and over you can get the last 30 days revisions for that file. This period is extended Dropbox Business.

Uninstalling the Dropbox desktop app will not delete your Dropbox account or remove the Dropbox folder from your hard drive. If you’d like to uninstall the Dropbox desktop app from your computer, follow the instructions for your device below.

How to uninstall the Dropbox desktop app on Mac

API Documentation

To uninstall the Dropbox desktop app on a Mac computer:

  1. Click the Dropbox icon in the menu bar.
  2. Click your avatar (profile picture or initials).
  3. Click Quit.
  4. Open Finder.
  5. Click Applications.
  6. Drag Dropbox to the Trash.

If you’d also like to remove the Dropbox folder from your hard drive, drag your Dropbox folder to the Trash.


How to uninstall the Dropbox desktop app on Windows

To uninstall the Dropbox desktop app on a Windows computer:

Dropbox Command Line
  1. Click Start.
  2. Click Settings.
  3. Click Apps.
  4. Click Apps & features.
  5. Click Dropbox.
    • Note: If Dropbox came preloaded on your device, you may see Get Dropbox or Dropbox “x” GB instead.
  6. Click Uninstall.

Ubuntu Dropbox Command Line

If you’d also like to remove the Dropbox folder from your hard drive, drag your Dropbox folder to the Recycle Bin.

How to uninstall the Dropbox desktop app on Linux

It Is All Said And Just To Add Another Vote; I Agree That A Functional Command Line Interface For Dropbox On OSX Would Be Extremely Useful!

To uninstall the Dropbox desktop app on a Linux computer, copy and paste the following commands one-by-one into your terminal window, hitting Enter after each command. Some of the commands listed may produce an error, but by the last command, the desktop app will be successfully uninstalled from your computer.