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

# Installation

> Install and update the Devbox CLI on macOS, Linux, or Windows.

Install the Devbox CLI with the install script for your operating system. Homebrew is an alternative on macOS and Linux.

## Install

> [tab] macOS
>
> ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> curl -fsSL get.namespace.so/devbox/install.sh | bash
> ```

> [tab] Linux
>
> ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> curl -fsSL get.namespace.so/devbox/install.sh | bash
> ```

> [tab] Windows
>
> Run the following command in PowerShell:
>
> ```powershell theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> irm https://get.namespace.so/devbox/install.ps1 | iex
> ```
>
> Restart your terminal if `devbox` is not available on your `PATH` after installation.

> [tab] Homebrew
>
> Alternatively, install with Homebrew on macOS or Linux:
>
> ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> brew install namespacelabs/devbox/cli
> ```
>
> If Homebrew asks you to trust the cask, run the following command and retry the installation:
>
> ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> brew trust --cask namespacelabs/devbox/cli
> ```

### Install a specific version

Pass a release version to the install script to install that release instead of the latest one. The version may include a leading `v`.

> [tab] macOS and Linux
>
> ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> curl -fsSL get.namespace.so/devbox/install.sh | bash -s -- --version 0.0.194
> ```

> [tab] Windows
>
> ```powershell theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> & ([scriptblock]::Create((irm https://get.namespace.so/devbox/install.ps1))) -Version 0.0.194
> ```

## Update

If you installed with the install script, update with the CLI:

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
devbox update
```

If you installed with Homebrew, update with Homebrew:

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
brew upgrade --cask namespacelabs/devbox/cli
```


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