Configuration

Administrators can configure startup options for a JetStream server such as creating superuser, or setting network parameters. Although setting a licensing, sandboxing, and bandwidth limits may be set in the configuration file, these can be set more flexibly through the Client Application or the API.

For the complete list of JetStream configuration options, please see jetstream server and jetstream relay_server command reference.

Editing Configuration

JetStream services use response files for configuration, which contain all arguments that would normally be given on the command line. The arguments can be specified on a single line or argument per line for better readability. For example /etc/jetstream-server.rsp:

--api-allow-remote-control
--trigger-dir=/var/lib/jetstream/triggers
--persistent-state-dir=/var/lib/jetstream/state

After editing configuration response files for one of the services, you will need to restart the service in order for the changes to take effect.

See also

Linux (CentOS, Ubuntu)

The jetstream-server startup arguments can be specified in the /etc/jetstream-server.rsp file, and jetstream-relay startup arguments in the /etc/jetstream-relay.rsp file. For example, setting a superuser would involve the following:

# sudo vi /etc/jetstream-server.rsp
--api-allow-remote-control
--trigger-dir=/var/lib/jetstream/triggers
--persistent-state-dir=/var/lib/jetstream/state
--superuser=user
# sudo systemctl restart jetstream-server

macOS

The jetstream-server startup arguments can be specified in the /usr/local/jetstream/etc/jetstream-server.rsp file, and jetstream-relay startup arguments in the /usr/local/jetstream/etc/jetstream-relay.rsp file. For example, setting a superuser would involve the following:

# sudo vi /usr/local/jetstream/etc/jetstream-server.rsp
--api-allow-remote-control
--trigger-dir=/var/lib/jetstream/triggers
--persistent-state-dir=/var/lib/jetstream/state
--log=/var/log/jetstream-server.log
--superuser=user
# sudo launchctl kickstart -k system/io.gojetstream.jetstream-server

License Configuration

JetStream server requires a license to send or receive transfers. You can set the server license key in several ways, such as:

Client Application

Use the Client Application to configure the server using a graphical user interface. Requires setting up a Location with a user with superusers privileges.

Command-line

The license can be set on the command-line. Run the following command and enter your regular password when prompted (assumes that the current user has administrator privileges; sudo is not required).

  • Linux:
# /usr/local/bin/jetstream api setLicenseKey --key=123456789
  • macOS:
# /usr/local/jetstream/bin/jetstream api setLicenseKey --key=123456789

API

The license can be set by using the setLicenseKeyAsync() API call (requires a user with superusers privileges).

Configuration File

The license can be set by adding the --license-password argument to your startup configuration (see Editing Configuration for the location of the configuration file on each platform). For instance, on Linux you could do the following:

# sudo vi /etc/jetstream-server.rsp
--api-allow-remote-control
--trigger-dir=/var/lib/jetstream/triggers
--persistent-state-dir=/var/lib/jetstream/state
--license-password=123456789

Please contact sales@gojetstream.io to obtain your license key.

See also

License Configuration

JetStream server requires a license to send or receive transfers. You can set the server license key in several ways, such as: JetStream server can be configured to receive transfers from multiple ports. You can set the receiver ports within the configuration file:

Configuration File

Set the receiver ports by adding the --recv-port argument to your startup configuration (see Editing Configuration for the location of the configuration file on each platform). For instance, on Linux you could do the following:

# sudo vi /etc/jetstream-server.rsp
--api-allow-remote-control
--trigger-dir=/var/lib/jetstream/triggers
--persistent-state-dir=/var/lib/jetstream/state
--license-password=123456789
--recv-port=8886 8887 8888 8889