# Install
Common issues when installing Valdr via Homebrew or verifying the CLI after install.

## `valdr: command not found` after install

**Symptom:** Homebrew installation succeeds but `valdr version` returns `command not found`.

**Likely cause:** Your shell's `PATH` does not include Homebrew's bin directory, or the shell has not reloaded since install.

**Fix:**

```bash
brew --prefix
echo $PATH
command -v brew
command -v valdr

# Reload your shell config if needed
source ~/.zshrc   # or ~/.bashrc
```

On Apple Silicon, Homebrew usually installs to `/opt/homebrew/bin`. On Intel Macs, it is usually `/usr/local/bin`. If `command -v valdr` is still empty after reloading, open a new terminal window and try again.

## `brew install valdr` fails with tap not found

**Symptom:** Homebrew says the `valdr` formula does not exist.

**Likely cause:** The Valdr tap was not added first.

**Fix:**

```bash
brew tap projectviking-ai/valdr https://github.com/projectviking-ai/homebrew-valdr.git
brew install valdr
```

## Wrong architecture

**Symptom:** `valdr version` returns an architecture mismatch error.

**Likely cause:** You are running a binary built for a different CPU architecture.

**Fix:**

```bash
# Check your architecture
uname -m   # arm64 on Apple Silicon, x86_64 on Intel

# Reinstall via Homebrew so it picks the correct bottle
brew reinstall valdr
```

## Permission denied running `valdr`

**Symptom:** Running a copied or extracted `valdr` binary returns `permission denied`.

**Likely cause:** The file is not marked executable.

**Fix:**

```bash
chmod +x ./valdr
```

If you installed with Homebrew, prefer the brewed binary returned by `command -v valdr`. Reinstalling with Homebrew is usually the quickest fix.

## Related

- [Install Valdr](/valdr/docs/getting-started/install/) — the canonical install guide