Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 22 additions & 11 deletions platform-cloud/docs/cli/installation.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,13 @@
---
title: "Installation"
description: "Seqera Platform CLI installation and configuration instructions."
date: "16 Jul 2024"
date created: "2024-07-16"
last updated: "2025-08-18"
tags: [cli, platform, installation, configuration]
---

### Option 1: Download latest binary

1. Download the latest [version][releases] for your OS from the CLI GitHub repository.
1. Rename the file and and make it executable:

Expand All @@ -19,9 +22,17 @@ tags: [cli, platform, installation, configuration]
sudo mv tw /usr/local/bin/
```

### Option 2: Install through Homebrew (Linux and macOS)

tw-cli is published to the Seqera Homebrew tap and can be installed like this:

```bash
brew install seqeralabs/tap/tw
```

### Configuration

The CLI requires an access token to interact with your Seqera Platform instance. Select **User tokens** from the user menu in the [Platform UI](https://cloud.seqera.io), then select **Add token** to create a new token.
The CLI requires an access token to interact with Seqera Platform. Select **User tokens** from the user menu in the [Platform UI](https://cloud.seqera.io), then select **Add token** to create a new token.

Copy the access token value and use it with the CLI in one of two ways:

Expand Down Expand Up @@ -62,12 +73,12 @@ tw info
Details
-------------------------+----------------------
Tower API endpoint | <TOWER_API_ENDPOINT>
Tower API version | 1.25.0
Tower version | 24.2.0_cycle22
CLI version | 0.9.4 (f3e846e)
CLI minimum API version | 1.15
Authenticated user | <username>
Tower API version | 1.25.0
Tower version | 24.2.0_cycle22
CLI version | 0.9.4 (f3e846e)
CLI minimum API version | 1.15
Authenticated user | <username>

System health status
---------------------------------------+------------------
Remote API server connection check | OK
Expand Down Expand Up @@ -95,7 +106,7 @@ If you are using a Private CA SSL certificate not recognized by the default Java
tw -Djavax.net.ssl.trustStore=/absolute/path/to/cacerts -Djavax.net.ssl.trustStorePassword=<your-password> info
```

Replace `<your-password>` with your keystore password. If you did not set a password when creating the keystore, include the default keystore password `changeit` in the command above.
Replace `<your-password>` with your keystore password. If you did not set a password when creating the keystore, include the default keystore password `changeit` in the command above.

You can also rename the binary to `tw-binary` and create a `tw` script to automatically include the custom `cacerts` store in every session:

Expand Down Expand Up @@ -144,7 +155,7 @@ tw CLI is a platform binary executable created by a native compilation from Java
========================================================================================================================
Finished generating 'tw' in 1m 6s.
[native-image-plugin] Native Image written to: <tower-cli-repository-root>/build/native/nativeCompile

BUILD SUCCESSFUL in 1m 8s
6 actionable tasks: 2 executed, 4 up-to-date
```
Expand All @@ -163,4 +174,4 @@ Run a non-binary development version by executing the [`./tw`](https://github.co

[Mozilla Public License v2.0](https://github.com/seqeralabs/tower-cli/blob/master/LICENSE.txt)

[releases]: https://github.com/seqeralabs/tower-cli/releases
[releases]: https://github.com/seqeralabs/tower-cli/releases
3 changes: 2 additions & 1 deletion platform-enterprise_docs/data/data-explorer.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
title: "Data Explorer"
description: "Using Seqera Data Explorer."
date: "08 May 2025"
date created: "2025-05-25"
last updated: "2025-08-18"
tags: [data, explorer]
---

Expand Down
Loading