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

# Installation

> Install Lukan Agent on your machine and verify it is ready.

## Install with one command

```bash theme={null}
curl -fsSL https://get.lukan.ai/install.sh | bash
```

The installer:

* Detects OS and architecture (including Rosetta 2 for Apple Silicon)
* Downloads from primary CDN, falls back to GitHub Releases
* Verifies SHA-256 checksums before installing
* Configures PATH if needed
* Installs `lukan`, `lukan-desktop`, and `lukan-bridge` to `~/.local/bin/`

## Supported platforms

| OS            | Architecture                   |
| ------------- | ------------------------------ |
| Linux (glibc) | x86\_64, arm64                 |
| macOS         | x86\_64, arm64 (Apple Silicon) |

<Note>
  Alpine/musl and Windows are not supported. Use WSL on Windows.
</Note>

## Install specific version

```bash theme={null}
curl -fsSL https://get.lukan.ai/install.sh | bash -s v1.2.3
```

## Verify installation

```bash theme={null}
lukan --version
```

If the command returns a version, Lukan Agent is installed correctly.

## First run

```bash theme={null}
lukan
```

This opens the interactive assistant in your terminal.

## Configure

```bash theme={null}
lukan setup
```

This interactive wizard helps you:

1. Select a model provider
2. Enter your API key
3. Set your timezone

## Sandbox (optional)

Enable OS-level sandboxing with `bwrap` for secure tool execution:

```bash theme={null}
lukan sandbox setup    # Install and configure bwrap
lukan sandbox on       # Enable sandboxing
lukan sandbox status   # Check sandbox status
```

<Note>
  If your shell does not find `lukan`, restart your terminal session and run `lukan --version` again.
</Note>

## Updating

```bash theme={null}
lukan update
```

Downloads and verifies the latest version, then reinstalls. Falls back to GitHub Releases if primary CDN is unavailable.

```bash theme={null}
lukan update --daily   # Install from the unstable/daily channel
```