> For the complete documentation index, see [llms.txt](https://support.marscat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.marscat.io/development-tools/relayx-cli.md).

# RelayX CLI

RelayX CLI is a command-line tool for creating, publishing, and managing MarsApp. Through simple commands, you can complete the full lifecycle management of MarsApp, including creation, signing, publishing, deployment, and permission management functions.

## Download

**Linux (x64)** Requires glibc 2.34 or higher

```bash
# Download
wget -L https://github.com/RelayX-Protocol/RelayX-CLI/releases/latest/download/relayx-cli-linux-x64.zip

# Extract
unzip relayx-cli-linux-x64.zip
```

**macOS** Supports macOS 10.15 (Catalina) and above

Intel chip (x64):

```bash
# Download
wget -L https://github.com/RelayX-Protocol/RelayX-CLI/releases/latest/download/relayx-cli-macos-x64.zip

# Extract
unzip relayx-cli-macos-x64.zip
```

Apple M series chip (arm64):

```bash
# Download
wget -L https://github.com/RelayX-Protocol/RelayX-CLI/releases/latest/download/relayx-cli-macos-arm64.zip

# Extract
unzip relayx-cli-macos-arm64.zip
```

## Installation

{% stepper %}
{% step %}

### Add execution permissions

```bash
chmod +x ./relayx-cli
```

{% endstep %}

{% step %}

### Move to system path (recommended)

```bash
sudo mv ./relayx-cli /usr/local/bin/relayx-cli
```

{% endstep %}

{% step %}

### Verify installation

```bash
relayx-cli version
```

{% endstep %}
{% endstepper %}

{% hint style="info" %}
macOS Tip: If macOS prompts "unable to verify developer" or blocks execution when running the tool, execute the following command to remove the quarantine attribute:

```bash
xattr -rd com.apple.quarantine /usr/local/bin/relayx-cli
```

{% endhint %}

## Account Description

Each MarsApp contains the following account types, with different permissions and purposes:

<details>

<summary><strong>Owner</strong></summary>

* Each MarsApp has 1 Owner account
* Purpose: Used for MarsApp signing operations to ensure application integrity and prevent tampering
* Important Notice: ⚠️ Please backup properly, cannot be recovered if lost

</details>

<details>

<summary><strong>Master</strong></summary>

* Each MarsApp has 1 Master account
* Purpose: Has complete MarsApp publishing permissions and Agent management permissions

</details>

<details>

<summary><strong>Agent</strong></summary>

* Each MarsApp can create multiple Agent accounts
* Purpose: Publishing sub-accounts authorized by Master, used for team collaboration, can be assigned to different team members for publishing operations

</details>

<details>

<summary><strong>Self</strong></summary>

* Each MarsApp can optionally create 1 Self account
* Purpose: Used for applying for Self Service certificates and configuring Self Service functionality

</details>
