# Installation (/cli/installation)





Use the hosted installer to download the current release for your platform. No Node.js runtime is required.

## Install [#install]

<Tabs items="['macOS / Linux', 'Windows']">
  <Tab value="macOS / Linux">
    ```bash
    curl -fsSL https://www.mogplex.com/install.sh | sh
    ```
  </Tab>

  <Tab value="Windows">
    ```powershell
    iwr -useb https://www.mogplex.com/install.ps1 | iex
    ```
  </Tab>
</Tabs>

<Callout>
  The PowerShell installer currently targets Windows x64. Windows ARM64 is not
  supported yet.
</Callout>

## What the installer changes [#what-the-installer-changes]

The installer downloads the current release archive, extracts the `mogplex` binary, and installs it into the Mogplex home bin directory:

* macOS and Linux: `~/.mogplex/bin/mogplex`
* Windows: `%USERPROFILE%\.mogplex\bin\mogplex.exe`

It then tries to make `mogplex` runnable immediately:

* on macOS and Linux it first tries to link `mogplex` into a writable directory already on your `PATH`
* if that is not possible, it updates your shell profile or prints the export command
* on Windows it updates the user `PATH` for future PowerShell sessions

If you want a different install location, set `MOGPLEX_INSTALL_DIR` before running the installer.

## Installer environment variables [#installer-environment-variables]

* `MOGPLEX_INSTALL_DIR` — override the install location.
* `MOGPLEX_VERSION` — pin to a specific release instead of the latest.
* `MOGPLEX_BASE_URL` — override the manifest host (must be HTTPS).

Examples:

```bash
MOGPLEX_INSTALL_DIR="$HOME/.local/bin" \
  curl -fsSL https://www.mogplex.com/install.sh | sh
```

```bash
MOGPLEX_VERSION=0.2.0 \
  curl -fsSL https://www.mogplex.com/install.sh | sh
```

## Verify the install [#verify-the-install]

```bash
mogplex --version
```

If your current shell still does not see it, run:

```bash
rehash
# or
exec zsh -l
```

## First run [#first-run]

```bash
mogplex
```

The first launch opens the in-app login screen. Sign in with your Mogplex
account. Mogplex never requires environment variables for normal use.

For the full first-run flow, continue with [Quickstart](/cli/quickstart).

## Upgrade [#upgrade]

Re-run the installer. It detects the existing install and replaces the binary in place.

## Troubleshooting [#troubleshooting]

* `mogplex: command not found` — the install succeeded but your shell has not picked up the updated `PATH`. Rehash or open a new shell.
* The installer downloads but fails before extraction — confirm your machine has the right extractor (`tar` for `.tar.gz`, `unzip` or `ditto` for `.zip`).
* You pinned `MOGPLEX_BASE_URL` and the script exits immediately — the installer rejects non-HTTPS hosts.
* Login succeeds but prompts fail — your account probably lacks model access.
  Check [Available Models](/web/models) and [Plans & Billing](/plans-and-billing).

## Uninstall [#uninstall]

Delete the `mogplex` binary from the location the installer reported. Local state in `~/.mogplex/` is left untouched.

Remove that directory too if you want to clear config, auth, logs, permissions, and other local state.