How to access Dropbox from the command line in Linux

Last updated on June 1, 2020 by Dan Nanni

Cloud storage is everywhere in today's multi-device environment, where people want to access content across multiple devices wherever they go. Dropbox is the most widely used cloud storage service thanks to its elegant UI and flawless multi-platform compatibility. The popularity of Dropbox has led to a flurry of official or unofficial Dropbox clients that are available across different operating system platforms.

Linux has its own share of Dropbox clients: CLI clients as well as GUI-based clients. Dropbox Uploader is an easy-to-use Dropbox command-line client written in Bash scripting language. In this tutorial, I describe how to access Dropbox from the command line in Linux by using Dropbox Uploader.

Install and Configure Dropbox Uploader on Linux

To use Dropbox Uploader, download the script and make it executable.

$ wget
$ chmod +x

Make sure that you have installed curl on your system, since Dropbox Uploader runs Dropbox APIs via curl.

To configure Dropbox Uploader, simply run When you run the script for the first time, it will ask you to grant the script access to your Dropbox account.

$ ./

As instructed above, go to on your web browser (you need to log in), and create a new Dropbox app. Fill in the information of the new app as shown below, and enter the app name as generated by Dropbox Uploader.

After you have created a new app, you will see app key/secret on the next page. Make a note of them.

Enter the app key and secret in the terminal window where is running. will then generate an oAUTH URL (e.g.,

Go to the oAUTH URL generated above on your web browser, and allow access to your Dropbox account.

This completes Dropbox Uploader configuration. To check whether Dropbox Uploader is successfully authenticated, run the following command.

$ ./ info
Dropbox Uploader v0.12

 > Getting info... 

Name:    Dan Nanni
Email:    my@email_address
Quota:  2048 Mb
Used:    13 Mb
Free:  2034 Mb

Dropbox Uploader Examples

To list all contents in the top-level directory:

$ ./ list

To list all contents in a specific folder:

$ ./ list Documents/manuals

To upload a local file to a remote Dropbox folder:

$ ./ upload snort.pdf Documents/manuals

To download a remote file from Dropbox to a local file:

$ ./ download Documents/manuals/mysql.pdf ./mysql.pdf

To download an entire remote folder from Dropbox to a local folder:

$ ./ download Documents/manuals ./manuals

To create a new remote folder on Dropbox:

$ ./ mkdir Documents/whitepapers

To delete an entire remote folder (including all its contents) on Dropbox:

$ ./ delete Documents/manuals

Support Xmodulo

This website is made possible by minimal ads and your gracious donation via PayPal or credit card

Please note that this article is published by under a Creative Commons Attribution-ShareAlike 3.0 Unported License. If you would like to use the whole or any part of this article, you need to cite this web page at as the original source.

Xmodulo © 2021 ‒ AboutWrite for UsFeed ‒ Powered by DigitalOcean