---
title: "Installing OneSpan Authentication Server (Basic installation)"
slug: "oas-iglnx-installing-onespan-authentication-server-basic-installation-3-28"
updated: 2025-12-11T11:07:40Z
published: 2025-12-11T11:13:25Z
canonical: "docs.onespan.com/oas-iglnx-installing-onespan-authentication-server-basic-installation-3-28"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onespan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installing OneSpan Authentication Server (Basic installation)

## Before you begin

- Ensure that you successfully completed and verified the required pre-installation tasks and settings (see [Pre-installation tasks and considerations](/sec/docs/oas-iglnx-pre-installation-tasks-and-considerations-3-28)), in particular the following:
  - You are logged on using a user account with sufficient administrative privileges on the machine to run the installation.

## Installing OneSpan Authentication Server

To install OneSpan Authentication Server (basic installation)

1. Open a terminal window.

Ensure that the terminal window resolution is at least 80x24. Otherwise the Configuration Wizard cannot start automatically after the installation or upgrade.
2. Log on as root using the hyphen option (su -).

This ensures you load the root profile, not the default profile.
3. Navigate to the mounted disk or ISO image containing the OneSpan Authentication Server setup files and locate the OneSpan Authentication Server install script install.sh.
4. Run ./install.sh.

The install script will guide you through the installation.
5. Type the installation mode to run, in this case: basic.
6. Use Space to scroll through the OneSpan license agreement and type yes to accept it.
7. If required, specify whether to encrypt the embedded MariaDB database and database connections.

If you want to use encryption for the data store and all connections to the embedded database, type yes. Type no to leave it unencrypted.

> Once you decide to use (or not use) encryption for the embedded database and all database connections, encryption will remain permanently enabled (or disabled). You cannot change this setting at a later time!
8. If required, install any [missing dependencies](/sec/docs/oas-iglnx-installing-required-dependencies-3-28).

The script is designed to install as many dependencies as possible. However, due to license and other restrictions, not all required standard packages are shipped with the OneSpan Authentication Server setup. Any required dependency that is not already installed and cannot be installed by the script automatically, is listed and you are prompted to install it now.

> When you install the embedded MariaDB database on **Red Hat Enterprise Linux**, you might get a conflict with older MariaDB or MySQL packages, such as:
> 
> > file /etc/my.cnf from install of MariaDB-common-10.11.5-1.el7.centos.x86_64 conflicts with file from package mysql-libs-5.1.73-3.el6_5.x86_64
> 
> or
> 
> > error: Failed dependencies:
> > 
> > mariadb-libs < 1:10.1.0 conflicts with MariaDB-compat-10.11.5-1.el7.centos.x86_64
> > 
> > mariadb-libs is obsoleted by MariaDB-compat-10.11.5-1.el7.centos.x86_64
> 
> To resolve this issue, the conflicting package needs to be removed. This can be done using rpm --erase --nodeps <package-name> for mariadb-libs.
> 
> This command normally needs to be executed with root permissions (e.g. using sudo).

> When you install the embedded MariaDB database on **Red Hat Enterprise Linux 9** or **Rocky Linux 9**, you might get a package conflict, such as:
> 
> > Package rhel9/MariaDB-shared obsoletes following packages: mariadb-connector-c, mariadb-connector-c-config
> 
> To resolve this issue, the conflicting package needs to be removed. This can be done using the following command:
> 
> > dnf remove mariadb-connector-c*
> 
> Note that removing the mariadb-connector-c and mariadb-connector-c-config packages might also implicitly remove other applications installed.

The necessary OneSpan Authentication Server components have now been installed by the installer.
  1. Open a separate terminal window.
  2. Install the required packages according to your Linux distribution.
  3. Return to the terminal window where the OneSpan Authentication Server script is running and press Enter.

## Next steps

When the required components have been installed, the Configuration Wizard is started to complete the initial configuration (see [Configuring OneSpan Authentication Server (basic installation)](/sec/docs/oas-iglnx-configuring-onespan-authentication-server-basic-installation-3-28)).