Installation

This guide will show you how to quickly get Raijin set up and running.

Supported platforms

The following operating systems and architectures are fully supported.

Table 1. Supported GNU/Linux platforms
Operating System Architectures

Redhat Enterprise Linux 7

x86_64

Redhat Enterprise Linux 8

x86_64

SUSE Linux Enterprise Server 15

x86_64

Debian 9

x86_64

Debian 10

x86_64

Debian 11

x86_64

Ubuntu LTS 18.04

x86_64

Ubuntu LTS 20.04

x86_64

Generic RPM

x86_64

Generic DEB

x86_64

Installing from DEB packages

Installing dependencies

To list the dependencies, use the following command:

$ dpkg-deb -f raijin_amd64.deb Depends

Then make sure all listed dependencies are installed. Alternatively you can run apt-get install -f after trying to install the package with dpkg and getting an error due to the missing dependencies.

Installing the DEB package

To install the DEB package, run the following command as root:

# dpkg -i raijin_amd64.deb

Installing from RPM packages

Install the RPM package with the following command:

# rpm –ivh raijin.x86_64.rpm

Running Raijin server

As soon as the installation process is successfully completed, the raijin-server service is registered as a systemd service and automatically started. In order to manually control raijin-server, you can make use standard systemctl utility, e.g:

systemctl restart raijin-server

For the full list of possible commands and options see systemctl(1).

Installing and running Raijin server as a Docker application

To install and run Raijin as a Docker application, both the Docker Engine and the Docker Compose tools are required. For more information on installing Docker, consult the Get Docker documentation on Docker’s website.

The procedure is identical on all platforms that Docker supports.

  1. Download the Raijin Docker archive from the Downloads page.

  2. Extract the files from the compressed Docker archive.

    1. On Linux and macOS, you can use the following command.

      # tar zxf raijin-server_X.X.XXXX-docker.tar.gz

    2. On Windows, you can use a third-party tool like 7-Zip.

  3. After extracting the archive, change to the newly created directory where you should see the following files:

    • docker-compose.yml

    • Dockerfile

    • raijin.conf

    • raijin-server_X.X.XXXX_amd64.deb

    • README-txt

  4. To build, create, and start the container, execute the following command.

    # docker-compose up -d

    To recreate the container, execute the following command.

    # docker-compose up -d --build

    You can configure the port numbers in the docker-compose.yml file.

        ports:
      - "2500:2500"
    restart: always
    By default, the Raijin Docker container uses a separate volume for data to avoid any potential data loss during container updates.