Installation

There are several ways to install Soar on your Linux system. Choose the method that best suits your needs.

Quick Installation

Install Script

The fastest way to install Soar is using our installation script:

curl -fsSL https://soar.qaidvoid.dev/install.sh | sh

Or if you prefer using wget:

wget -qO- https://soar.qaidvoid.dev/install.sh | sh

The install script supports several environment variables to customize the installation:

  • SOAR_VERSION: Specify the version to install
# Install specific version
curl -qfsSL "https://soar.qaidvoid.dev/install.sh" | SOAR_VERSION=0.4.0 sh

# Install latest release
curl -qfsSL "https://soar.qaidvoid.dev/install.sh" | SOAR_VERSION=latest sh

# Install nightly build
curl -qfsSL "https://soar.qaidvoid.dev/install.sh" | SOAR_VERSION=nightly sh
  • SOAR_INSTALL_DIR: Specify custom installation directory
curl -qfsSL "https://soar.qaidvoid.dev/install.sh" | SOAR_INSTALL_DIR=~/.bin sh

Cargo (crates.io)

cargo install soar-cli

Manual Installation

From Binary Releases

  1. Visit the releases page

  2. Download the appropriate binary for your architecture:

    • soar-x86_64-linux for 64-bit Intel/AMD systems
    • soar-aarch64-linux for 64-bit ARM systems

  3. Make the binary executable:

chmod +x soar
  1. Move the binary to your desired location, for example /usr/local/bin:
sudo mv soar /usr/local/bin/soar
  1. Verify the installation by running soar --version:
soar --version

This should output the version number of the installed Soar binary.

From Source

To install Soar from source, you need to have Rust and Cargo installed. Follow these steps:

  1. Clone the Soar repository:
git clone https://github.com/QaidVoid/soar.git
  1. Navigate to the Soar directory:
cd soar
  1. Build and install the project:
cargo install --path .
  1. Verify the installation by running soar --version:
soar --version

This should output the version number of the installed Soar binary.

Next Steps

After installing Soar, you might want to:

  1. Configure Soar for your specific needs
  2. Learn about package management
  3. Try installing your first package