Installation

Multiple installation methods are available for the Noorle CLI.

Quick Install (Recommended)

Use the automated installer script:

curl -L cli.noorle.dev | sh

This will:

1. Detect your platform (Linux/macOS, x64/ARM64)
2. Download the appropriate binary
3. Install to ~/.noorle/bin/noorle
4. Add to your PATH automatically

After installation, open a new terminal or run:

source ~/.bashrc  # or ~/.zshrc for Zsh users

Manual Installation

For manual installation, download the appropriate binary for your platform from the latest release page.

After downloading:

chmod +x noorle
sudo mv noorle /usr/local/bin/

Verify Installation

After installing, verify the CLI is working:

# Check version
noorle --version

# View help
noorle --help

# List available templates
noorle plugin list-templates

System Requirements

• Operating System: macOS or Linux
• Architecture: x64 or ARM64
• Network: Internet connection for downloading templates and deploying

Note: Windows support is not yet tested. Windows users may need to use WSL (Windows Subsystem for Linux).

WebAssembly Toolset

Plugin development requires WebAssembly tools, which are automatically installed when you run:

noorle plugin prepare

This installs:

• wasmtime - WebAssembly runtime for local testing
• wkg - WIT package manager for dependency management
• wasm-tools - WebAssembly component utilities
• Rust toolchain - Required for the above tools

Authentication

Authenticate with the Noorle Platform for deployment:

noorle login

This will:

1. Open your browser for OAuth 2.0 authentication
2. Store authentication tokens securely
3. Cache platform configuration for offline work

Environment Variables

Customize CLI behavior:

# Enable debug logging
RUST_LOG=debug noorle plugin build

# Custom install directory
NOORLE_INSTALL=/opt/noorle

Troubleshooting

Common Issues

Permission Denied

# Make binary executable
chmod +x noorle

Command Not Found

# Add to PATH
export PATH=$PATH:/path/to/noorle

Authentication Issues

# Re-authenticate
noorle logout
noorle login

Update & Uninstall

# Check for updates
noorle check-update

# Uninstall (if using installer)
rm -rf ~/.noorle
# Remove from PATH in your shell config