Bulk Upload

To connect many hosts at once to the same central hub, follow these steps:

Click the Hosts link in the app header.
Click the “up arrow” (Bulk Upload) icon on the right side of the Hosts panel.

Hosts to Add

Enter (or copy and paste) a list of host names into the Hosts to Add field, one host to a line. For example:

Alice's Laptop
Bob's Phone
Carla's Workstation

Hub Host

Select an existing host with the Hub Host field to connect to each of the added hosts.

If you type part of a name in the Hub Host field, it will filter the displayed list of hosts from which to choose. Use the up and down arrow keys to highlight a host from the list, and use the tab or enter key to select the highlighted host.

Hub Interface

Select the interface of the hub host with the Hub Interface field to connect to each of the added hosts.

The selected interface must have the following endpoint defaults set:

Type

One of the following types:

Hub-and-Spoke, Remote as Spoke
Point-to-Site, Remote as Point
Point-to-Internet, Remote as Point

Allowed IPs

The IP addresses that the new hosts should route through the hub.

Hostname

The publicly-accessible DNS name or IP address of the hub.

Port

The publicly-accessible UDP WireGuard listen port for the hub.

Network Addresses

The network address blocks from which new WireGuard addresses will be chosen (one address from each block for each host).

These defaults will be applied to the added/updated hosts.

Download

Select one of the following options from the Download field to choose what to download once all the hosts have been added/updated:

Agent config files: Download a zip file containing the agent config and setup files for each host.
WireGuard config files: Download a zip file containing the WireGuard config file for each host.
Nothing: Don’t download anything.

You can download these same files from the Bulk Download page later.

Invalid Names

Select one of the following options from the Invalid Names field to choose what to do when a host name contains characters that cannot be used in a filename (such as ", *, /, :, <, >, ?, \, and |):

Skip and warn: If a host name contains characters that cannot be used as a filename, do not include the host in the zip download.
Strip invalid filename characters from download: If a host name contains characters that cannot be used as a filename, strip the invalid characters when including the host in the zip download.

Existing Hosts or Peers

Select one of the following options from the Existing Hosts or Peers field to choose what to do when the name of a host to add is the same as the name of an existing host or peer:

Skip and warn: If the name of a host to add is the same as an existing host or peer, skip it entirely.
Don’t modify, but include in download: If the name of a host to add is the same as an existing host or peer, don’t modify the existing host or peer, but do include the existing host in the zip download.
Add connection to hub if missing: If the name of a host to add is the same as an existing host or peer, update the existing host to connect it to the hub host — if the connection does not already exist.
Replace connection to hub with latest defaults: If the name of a host to add is the same as an existing host or peer, update the existing host to connect it to the hub host. If the connection already exists, replace it with the hub host’s current default settings.
Delete it and all connections and re-create from scratch: If the name of a host to add is the same as an existing host or peer, delete the existing host and peer with the same name, and then re-create them from scratch as if they hadn’t existed.

The Replace connection to hub with latest defaults option may change the settings of existing hosts. Be sure that the hub’s endpoint defaults are appropriate for all hosts listed in the Hosts to Add field.

The Delete it and all connections and re-create from scratch option will break the WireGuard connections of any existing hosts to which it is applied. Be sure that you really want to delete the current configuration of any existing host listed in the Hosts to Add field.

Form Submit

Click the Add button to submit the form and add/update the specified hosts.

A progress dialog will indicate the progress of the upload. When the upload is complete, a zip file will be downloaded according to your selection for the Download option.