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.

Your server should now be running.

Tip

On macOS 10.15 and above, it is recommended that you grant full disk access.

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 by making a simple API call on the command-line.

# /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"
}

Licensing

Transfers are disabled unless the server is licensed. The easiest way to configure a license is to connect to the server using the Client Application.

Licenses can also be configured using the command-line or editing a configuration file, as detailed in License Configuration.

Tip

Servers can only be configured by superusers, which includes all users in the admin group by default.

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.