Installing Rakaard 2

This guide describes how to install Rakaard 2 on Windows and Linux systems. Follow the section for the relevant operating system.

Before you begin

Make sure you have downloaded the latest installer or archive from the official Rakaard release page.

Windows Installation

Rakaard 2 for Windows uses a guided installer. Launch the installer and follow the displayed steps.

Steps

0/60%

• Download the Windows installer.

  The file is usually named something like rakaard-2.0.0-setup.exe.
• Double-click the installer to launch it.

  If Windows SmartScreen asks for confirmation, click "More info" then "Run anyway".
• Accept the User Account Control (UAC) prompt.

  This is required so Rakaard can register itself as a service.
• Click Next through the setup wizard steps.

  Accept the license agreement, choose the installation directory (or keep the default), and confirm.
• Click Finish once the installation completes.

  Rakaard will start automatically in the background.
• Open PowerShell or CMD and verify installation.

  Run: rakaard version

Verify the installation

Open PowerShell or Command Prompt and run:

rakaard version

You should see the current Rakaard CLI version and the running engine version.

Installation complete

Rakaard is installed and running as a background service. The rakaard CLI is now available from any terminal window.

SmartScreen warning

Windows may display a "Windows protected your PC" screen the first time you run the installer. This is normal for newly-signed installers. Click More info then Run anyway to proceed.

Linux Installation

On Linux, Rakaard is distributed as a compressed archive that contains an installation script.

Steps

0/50%

• Download the appropriate tar.gz archive.

  Choose the file matching your distribution — e.g., rakaard-2.0.0-linux-amd64-rpm.tar.gz for Fedora/RHEL or rakaard-2.0.0-linux-amd64-deb.tar.gz for Ubuntu/Debian.
• Extract the archive.

  tar -xzf rakaard-2.0.0-linux-amd64-rpm.tar.gz
• Move into the extracted folder.

  cd rakaard-2.0.0-linux-amd64-rpm/
• Run the install script.

  ./install.sh
• Verify installation.

  Run: rakaard version

Full command sequence

Run the following commands in a terminal:

tar -xzf rakaard-2.0.0-linux-amd64-rpm.tar.gz
cd rakaard-2.0.0-linux-amd64-rpm/
./install.sh

The install script will:

• Copy binaries into /usr/local/bin
• Register the Rakaard engine as a systemd service
• Start the service automatically

Verify the installation

rakaard version

You should see the current Rakaard CLI version and the running engine version.

Check service status

You can inspect the Rakaard engine service any time with:

systemctl status rakaard

Permissions

The install script may prompt for sudo since it needs to place files in system directories and register a systemd service.

After Installation

After installation, continue to the Quick Start guide to establish the first server connection.

What is next?

• Run rakaard shell to enter the interactive Rakaard shell.
• Use servers to see your configured servers.
• Use connect rakaard to connect to the public Rakaard coordinator.

Troubleshooting

Installation failed on Windows

Installation failed on Linux