Dataplicity Developer Hub

Dataplicity Documentation

Here you'll find announcements for new features and comprehensive guides to help you integrate Dataplicity into your Raspberry Pi projects.

Get Started    

Manage files with Wormhole

Remotely share and access your files at <yourdevice> using Cloud Commander

Managing files on your server is now even easier with Cloud Commander and Dataplicity Wormhole.


We'll assume that you have your Pi powered up, connected to the internet and have Dataplicity installed. If you need some help to get up to speed, see Getting started with Dataplicity.

Make sure to free up port 80

If you have been going through other tutorials for wormhole you might have an application or a service already running on port 80. Make sure that nothing is running on port 80 prior to following the instructions in this article.


Cloud Commander is a very powerful NodeJS application which provides an easy way to upload and download files to and from your Pi using a web browser. In addition, the graphical interface offers plenty of built in options which make it a great tool for file management.

Install NodeJS and NPM

Node.js is an open source, cross-platform runtime environment for server-side and networking applications programmed in javascript with some added functionalities.

NPM is a package manager for JavaScript programming language.

sudo curl -sL | sudo -E bash -
sudo apt-get install -y nodejs

Before proceeding, confirm that NodeJS and NPM are installed correctly.

nodejs --version
npm --version

At the time of writing this article, current versions are

  • NodeJS: v8.11.3
  • NPM: 5.6.0.

Install Cloud Commander

Cloud Commander is written in JavaScript and installed through NPM.

sudo npm i cloudcmd -g

You might see 2 warnings during installation, these are fine as long as there are no errors.

Run Cloud Commander

For the purpose of this document we'll run Cloud Commander as root user on port 80. This is for testing purposes and is not recommended way to run this application in production.

sudo cloudcmd --port 80 --auth

Which will let you access your Pi through wormhole. Login credentials are root with password toor. As this will expose your device to the open internet (along with the files), you'll definitely want to put your own password here.

Changing default credentials

To change default login and password please modify username and password fields of /usr/lib/node_modules/cloudcmd/json/config.json file with new login and SHA512 string for password which can be generated here.

For more information about securing apps hosted by wormhole, see Securing Wormhole.

Upload and Download files

Both of these operations can be performed with simple drag 'n drop from desktop to the web browser as we did with the funniest video on the internet in the picture below. Alternatively when right clicked on a file or in the folder area you will get a right click menu where you will see upload and download options.

Right click menu

Right click menu

More features

There are many more options, features and ways to configure Cloud Commander for which the documentation can be found on the official page.

Updated 4 months ago

Manage files with Wormhole

Remotely share and access your files at <yourdevice> using Cloud Commander

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.