A headless device is an instance of SpiderOak ONE or Groups that does not use the graphical user interface (GUI) and relies on the command line interface (CLI). It is intended for advanced users, and for that reason this and all our CLI instructions presume some familiarity with the command line on your operating system.
To set up a headless device, first create an account. An account cannot be created from the command line, but once created, you can set up and manage its devices from the command line.
Next, create your headless device with
After you have set up a device, your next step is to add one or more directories to its backup selection.
In order to actually begin uploading your newly selected directories you will run the client with either the
Note that we are running the client as user, which implies that the client has the user's permissions. Be sure that user has adequate permissions to read the files you want the client to back up. If not, best practice is to modify file permissions. Running any user application as root, ONE or Groups included, is hazardous and is not supported.
You may be wondering what to do about the GUI instance of ONE or Groups on the computer you used to open your account. Although you may delete it, most headless server administrators keep it for tasks that are more easily accomplished via the GUI.