macOS

Note

To install JetStream, you will need to either be logged in as root or be an administrative user using sudo. The examples below use sudo.

New Installation

To install JetStream on macOS, double click on the go-jetstream-<version>.pkg file.

Edit /usr/local/jetstream/etc/jetstream-server.rsp and add in your license key (provided by Jet Digital) by appending the --license-password option. For instance:

# 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
--license-password=12345678

Restart the service:

# sudo launchctl kickstart -k system/io.gojetstream.jetstream-server

Your server should now be fully operational.

Update Existing Installation

To update JetStream on macOS, double click on the go-jetstream-<version>.pkg file.

Check Service

You can check if the JetStream service is running by running the launchctl print command. Under normal circumstances, the command should report that the process is running. For example:

# launchctl print system/io.gojetstream.jetstream-server
io.gojetstream.jetstream-server = {
   active count = 1
   path = /usr/local/jetstream/etc/io.gojetstream.jetstream-server.plist
   state = running
   ...

Check Server

You can check that the server is active and licensed by making a simple API call on the command-line. If prompted for a password, just hit enter.

# /usr/local/jetstream/bin/jetstream api --no-auth getServerInfo
{
 "allowRemoteControl": true,
 "apiControlPort": 8886,
 ...
 "license": {
  "expiry": "2020-10-01 (365 days from now including today)",
  "valid": true
 },
 ...
 "version": "2.0.0"
}

Next Steps

Try connecting to the JetStream server and doing some transfers. See Connecting To JetStream for tips on setting up a connection. If you want to further customize your JetStream installation, see Setup.