Before you mirror your cloud to a device, it's probably best to take a look at our hosting best practices.

In order for your cloud files to be available wherever you are, you must first "mirror" the cloud to your device. This will set up Nebula to serve files on your PC to anywhere else in the world. Until you mirror your cloud to a device, it doesn't exist anywhere, but once the cloud is mirrored, each mirror will automatically keep each other updated.

Installation Requirements

Nebula is a Python 2.7 application, so you'll need to make sure to have that installed. Fortunately, many PC's come with that pre-installed, so you don't need to worry.

You can get Nebula from the github repository here, or with the following commandline:

git clone https://github.com/zadjii/nebula


To mirror a cloud, you can use the following commandline:

python nebs.py mirror [-d <directory to mirror into>] <remote url> <username/cloudname>
This will try to get the cloud <username/cloudname> from <remote url>, and place it into <directory to mirror into>.

Let's take a look at an example commandline for mirroring a cloud:

python nebs.py mirror starmap.io foo/home

In this example, we're mirroring the cloud "foo/home" from the remote at starmap.io into the current working directory.

Running the Nebula Server

To start service the files on all your clouds, you need to start the nebula server:

python nebs.py start

This will start the nebula server on your device for all the clouds that are mirrored to the deivce. If it's already running, it will automatically detect when you mirror a new cloud and start serving it automatically.