Create a Volt

A tdx Volt can be created using either the command-line interface (CLI) or the fusebox.

cli

Use the create cli command:

./volt create --help

The most simple way to create a tdx Volt from the command line is shown below.

In this example, the tdx Volt will be created in the default Battery, with no password protection or encryption on either the Battery storage or the tdx Volt itself.

./volt create "Alice's laptop"

Create a secure tdx Volt

Use the p switch to specify a password that will be used to encrypt the tdx Volt storage.

By default, the tdx Volt will auto-generate a new key at creation and encrypt it with the given password. The tdx Volt will not store the password so you must remember it.

./volt create "Alice's laptop" -p secret

Use a period . to force the CLI to prompt for the password rather than include it explicitly in the command line.

./volt create "Alice's laptop" -p .
> enter Volt passphrase: _

There is currently no way to recover or reset the **tdx Volt** password so if you lose it you will not be able to access the Volt.

Create a tdx Volt using a fixed host

By default when a tdx Volt is created its certificate is bound to the current (or first) ipv4 network interface address. If you would like to bind a tdx Volt to a specific IP address or domain name use the host and port command line switches.

./volt create "Alice's server" --host aliceserver.com --port 40725

Create a tdx Volt with a file-based key

By default the tdx Volt key is stored with the tdx Volt configuration. If the Battery and tdx Volt itself are encrypted this is a fairly safe option.

Alternatively you can create a tdx Volt using a key stored on the local file system.

./volt create "Alice's laptop" -k /path/to/key/file

If /path/to/key/file does not exist it will be created.

If the key is encrypted (recommended) you can specify or prompt for the password using the p switch as described above.

./volt create "Alice's laptop" -k /path/to/key/file -p .

It's possible to use this option to create a **tdx Volt** using a key stored on an encrypted USB stick for example. Of course the key file must be available to the **tdx Volt** when it is started.

Create a tdx Volt with a Relay

Use the relay-address and relay-challenge switches to create a tdx Volt with a pre-configured relay. This is useful in scenarios where the tdx Volt is created on remote devices, as it enables the configuration of a remote connection to the tdx Volt via the fusebox to complete the commissioning.

Note that you almost certainly want to use the -k switch to specify the file in which the tdx Volt key will be written. This is because you will need the key to be able to configure the remote fusebox connection.

./volt create --name "Alice's NAS" -k ./alice.key --relay-address https://tdxvolt.com --relay-challenge letmein

When the tdx Volt is first run it will create and configure the Relay connection and issue a bind request to the Relay Volt. The Relay Volt owner/administrator may need to approve the bind request before the binding is complete.

fusebox

Creating a tdx Volt using the fusebox is straightfoward. Use the ‘new Volt’ button on the slide-out menu panel:

Then fill out the form: