Skip to content
Documentation
Troubleshooting
Install

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:

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:

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:

# 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:

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

License