macOS¶

JetStream will install launchd agents io.gojetstream.jetstream-server and io.gojetstream.jetstream-relay for each service, and each with respective configuration files /usr/local/jetstream/etc/jetstream-server.rsp and /usr/local/jetstream/etc/jetstream-relay.rsp. The server service is loaded by default.

If you choose to install the optional Python package, refer to requirements if you don’t have pip installed on your system.

You will need to use an account with administrative rights in order to install JetStream. Execute all the Terminal commands as root or using sudo.

Install¶

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

To install the optional Python package, execute the following from Terminal:

pip install /usr/local/jetstream/share/jetstream-python

Tip

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

Update¶

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

To update the optional Python package, execute the following from Terminal:

pip install -U /usr/local/jetstream/share/jetstream-python

Uninstall¶

To uninstall JetStream, execute the following from Terminal:

launchctl bootout system /usr/local/jetstream/etc/io.gojetstream.jetstream-server.plist
launchctl bootout system /usr/local/jetstream/etc/io.gojetstream.jetstream-relay.plist
launchctl disable system/io.gojetstream.jetstream-server
launchctl disable system/io.gojetstream.jetstream-relay
rm -rf /usr/local/jetstream
rm -rf /var/lib/jetstream

To uninstall the optional Python package, execute the following in Terminal:

pip uninstall jetstream

Next Steps¶

Once you have JetStream Server running, you can try doing a test transfer using one of the available tools as outlined in Interacting with JetStream.