Installing the CLI

Control your Slasha instance from your local machine. The slasha CLI is a single, cross-platform binary that lets you manage apps, services, and deployments from your terminal.

Recommended: Automated Install

Use our install script to automatically detect your OS and architecture, download the latest release, and install it to ~/.local/bin:

curl -fsSL https://slasha.com/install.sh | bash

The script supports:

  • Linux: x86_64 and ARM64
  • macOS: Intel and Apple Silicon

Pro Tip: Re-running this script will automatically upgrade your CLI to the latest version.

Customizing the Installation

You can override the default version or installation directory using environment variables:

# Install a specific version
SLASHA_VERSION=v0.0.1 curl -fsSL https://slasha.com/install.sh | bash

# Install to a custom directory
SLASHA_INSTALL_DIR=/usr/local/bin curl -fsSL https://slasha.com/install.sh | bash

Alternative: Manual Installation

If you prefer to manage binaries yourself, you can download pre-compiled releases directly from our GitHub Releases page.

Using Cargo

If you have Rust installed, you can install the CLI directly from crates.io:

# CLI only — no server, no embedded frontend
cargo install slasha --no-default-features --features vendored

Or build it from source if you want to pick your own feature set:

git clone https://github.com/slashacom/slasha.git
cd slasha
cargo build --release -p slasha-cli

Verify the Installation

Run the version command to ensure the CLI is installed and accessible in your PATH:

slasha version

Authentication in CI/CD

While slasha login is great for local development, it uses the system keychain which isn’t available in CI environments (like GitHub Actions).

To authenticate in CI, set the SLASHA_TOKEN environment variable. The CLI will detect this token automatically and skip the keychain:

export SLASHA_TOKEN="your-secure-token"
slasha list

Configuration File

The CLI stores your server URL and settings in a config.toml file. Its location depends on your operating system:

  • Linux: ~/.config/slasha/config.toml
  • macOS: ~/Library/Application Support/slasha/config.toml
  • Windows: %APPDATA%\slasha\config.toml
Server SetupQuickstart