How do I set up a new device from the command line?

These instructions presume that you have already created an account. An account cannot be created from the command line, but once created, you can manage its devices from the command line.

To create or reinstall a device, run SpiderOak with the --setup option. The easiest way to do this on Mac and Linux is SpiderOakONE --setup=- (notice the trailing dash) which tells SpiderOak to set up a new device by prompting you interactively for setup parameters. When run this way, the process looks like this:

johndoe@jupiter:~$ SpiderOakONE --setup=-
Login: SOExample
Password: 
Logging in...
Getting list of devices...
id  name
1   jupiter
To reinstall a device, enter the id (leave blank to set up a new device): 1
Reinstalling device...
Finalizing device setup...
Generating encryption keys (this could take a while)...
Synchronizing with server (this could take a while)...
batchmode run complete: shutting down

This method of managing devices, prompting for setup parameters, is not available on Windows.

As mentioned above, --setup also supports using an external JSON file. This method is available on all supported operating systems (Windows, Mac, and Linux) and is particularly suitable for automation and replication. The format of the file is as follows:

{
    "username": "username",
    "password": "password",
    "reinstall": true | false,
    "device_name": "device name",
}

username can be either a username or an email address, but the parameter name is always username.

reinstall can be omitted, and defaults to false (i.e., set up a new device). If reinstall is true, then device_name is the name of an existing device to reinstall, otherwise device_name is the name of the new device to set up.

The instructions above presume that you are running the current version of our application. If you are running an older version, download and install our current version, then follow the instructions above.