TethysL CLI Installation¶

TethysL releases are available at https://okeanids.mbari.org/dl/tethysl/ (the latest version is indicated in tethysl_version.txt).

Release archive	Platform
`tethysl-X.Y.Z-linux.tgz`	Linux (x86_64)
`tethysl-X.Y.Z-macos.tgz`	macOS (Apple silicon)
`tethysl-X.Y.Z-windows.zip`	Windows (x86_64)

Each release is a standalone, native tethysl executable (tethysl.exe on Windows), starting with 5.0.0 (earlier releases were Java-based, with a bundled Java runtime). The archive also includes an install.sh script, which may be convenient (see below), but you can just as well copy the executable, from the archive's bin/ directory, to some location that is already in your PATH.

Install¶

Download the tethysl-X.Y.Z-<platform> archive for your platform in some location of your choice.
Open a terminal session in that location and unpack the archive, which creates directory tethysl-X.Y.Z/:
```
tar xf tethysl-X.Y.Z-<platform>.tgz
```
cd to that directory, and run ./install.sh <prefix>, which installs the executable as <prefix>/bin/tethysl. Examples:
- To install tethysl under ~/.local/bin/:
```
cd tethysl-X.Y.Z
./install.sh ~/.local
```
- To install tethysl under /usr/local/bin/:
```
cd tethysl-X.Y.Z
sudo ./install.sh /usr/local
```
Make sure that <prefix>/bin is in your PATH.
To verify the installation, run tethysl --version.

To update to a new release, just repeat these steps with the new archive. This also replaces any previous installation under the same <prefix>.

macOS

The macOS executable is not signed by a registered Apple developer. If you downloaded the archive with a web browser, macOS may refuse to run tethysl. To allow it, run:

xattr -d com.apple.quarantine <prefix>/bin/tethysl

(Not needed if you downloaded the archive with curl or wget.)

Windows

Unpack tethysl-X.Y.Z-windows.zip (e.g., with the File Explorer). Then, either:

using Git Bash, install it as on the other platforms:
```
cd tethysl-X.Y.Z
./install.sh <prefix>
```
which installs <prefix>/bin/tethysl.exe;
or just add the extracted tethysl-X.Y.Z\bin\ directory, with tethysl.exe, to your PATH.

lrauv-application

In an lrauv-application clone, the TethysL-related make targets (see Build/tethysl.mk) will install TethysL automatically (under Build/tethysl_downloads/) if tethysl is not found in the PATH.

tethyshub

On tethyshub, TethysL is installed under /opt/tethysl/bin/, which is in the PATH for all users.