> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoista.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Hoista

> Install the CLI, the daemon and Desktop.

Hoista has two core programs. `hoist` is the CLI and `hoistd` is the daemon. Desktop is an optional app that uses the same daemon. Pick your system:

```bash macOS and Linux theme={null}
curl -fsSL https://hoista.dev/install.sh | sh -s -- v0.1.0-beta.2
```

```powershell Windows theme={null}
.\install.ps1 -Version v0.1.0-beta.2
```

```bash From source theme={null}
git clone https://github.com/TheDhejavu/hoista.git
cd hoista
cargo install --locked --path bin/hoist
cargo install --locked --path bin/hoistd
```

The version is required. Both scripts need [cosign](https://docs.sigstore.dev/cosign/system_config/installation/) 3: they check the release's signature with it and stop if it's missing or the check fails.

## macOS and Linux

The script works on macOS (Apple Silicon or Intel) and Linux (x86\_64). It installs `hoist` and `hoistd` into `~/.local/bin`, then runs `hoist service install` so Hoista starts at login. Add that folder to your `PATH` if it isn't there. It takes two more arguments, in this order:

| Argument | Use |
| - | - |
| `[destination]` | Install into this folder instead of `~/.local/bin` |
| `--start-at-login` or `--no-service` | Start Hoista at login (the default), or install the binaries only |

To skip login startup, give the folder too:

```bash theme={null}
curl -fsSL https://hoista.dev/install.sh | sh -s -- v0.1.0-beta.2 "$HOME/.local/bin" --no-service
```

Without the login service, `hoist` still starts the daemon when a command needs it.

## Windows

On Windows (x86\_64), run `scripts/install/install.ps1` from the repository. It installs `hoist.exe` and `hoistd.exe` into `%LOCALAPPDATA%\Hoista\bin`. Add `-Destination PATH` to choose another folder, and `-NoService` to skip login startup.

There is no Desktop app for Windows; the CLI and daemon are all you need.

## From source

You need [Rust](https://rustup.rs); rustup installs the version pinned in `rust-toolchain.toml`. `cargo install` builds `hoist` and `hoistd` in release mode and puts both in `~/.cargo/bin`. Keep them in the same folder: the CLI starts the daemon from there. Run `hoist service install` after they're in place to start Hoista at login. The login service records their path, so moving them later breaks it.

To build Desktop from source, you also need Node.js 22 or later. On Linux, install the system webview's libraries first: `libwebkit2gtk-4.1-dev`, `libayatana-appindicator3-dev` and `librsvg2-dev` on Debian and Ubuntu.

```bash theme={null}
npm ci
npm run desktop:build
```

The app is in `apps/desktop/src-tauri/target/release/bundle/`. On Linux, ask for a package with `npm run desktop:build -- --bundles deb,appimage`.

## Desktop app

Download Desktop from [GitHub releases](https://github.com/TheDhejavu/hoista/releases). Use only the files listed on the release page.

| System | Package |
| - | - |
| macOS | Apple Silicon and Intel |
| Linux | AppImage and Debian package |

Desktop uses the same daemon as the CLI, so install the CLI and daemon too.

## Check it works

```bash theme={null}
hoist --version
hoist doctor
```

`hoist doctor` checks that everything is installed and working.

To run Hoista in your own cloud account instead, see [your remote](https://docs.hoista.dev/guides/remote.md).

## Related

> [card] [Quickstart](https://docs.hoista.dev/getting-started/quickstart.md)
>
> Connect a provider and add your first project.

> [card] [Keep the daemon running](https://docs.hoista.dev/guides/daemon.md)
>
> Start Hoista at login and check on it.

> [card] [Your remote](https://docs.hoista.dev/guides/remote.md)
>
> Run Hoista in your own cloud account.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.