@tdxvolt/volt-drive

@tdxvolt/volt-drive

Bi-directional synchronisation of folders between two or more locations.

Usage

The application is parameterised using 3 arguments:

argument	short	description
--folder	-f	The path to the folder to be synchronised. This can be a relative or absolute path.
--database	-d	The id or alias of the Volt resource to use as the sync database.
--volt	-v	The DID or HTTP URL of the Volt that is hosting the sync database. This is an alternative to providing a configuration file using --config or -c.
--config	-c	The path to the configuration file containing credentials for accessing the Volt that is hosting the sync database. This is an alternative to providing a Volt DID or HTTP URL using --volt or -v.

Example

To synchronise a folder called project-acme in the home directory with a Volt resource called @acme-db using the configuration file volt.config.json located in the home directory:

npx @tdxvolt/volt-drive -f /home/user/project-acme -d @acme-db -c /home/user/volt.config.json

Demo

Running the application with no arguments will synchronise with a demonstration database hosted on a Volt running in the cloud to a local folder called demo in the current working directory.

npx @tdxvolt/volt-drive

Setup

As outlined above, volt-drive requires details of a sync database Volt resource to synchronise with. The identifier or alias of the resource is given using the --database or -d argument to the application, and the credentials for connection to the Volt are given using --config or -c.

You can run volt-drive using details that have been shared with you, or you can create your own sync database resource and configure the application to use it.

The Volt management console fusebox is the easiest way to create and manage Volt resources. Use the new menu in the toolbar and select the sync database option from the menu.

The Volt credentials are stored in a JSON file.

You can create an account via the fusebox by navigating to the account folder and selecting the new button from the toolbar.

Make sure to share the sync database created above with the new account. You should give it database-read permission to allow it to receive synchronisation updates, and database-write permission if you want to permit the application to create synchronisation updates.

Once the account has been created, you can copy the credentials from the fusebox and paste them into the volt.config.json file.

Daemonise

The application can be daemonised using PM2.

pm2 start npx @tdxvolt/volt-drive -- -f /path/to/folder -d sync-db-id -c /path/to/volt.config.json