Installation flow

This document describes the overall flow for installing the ALM Octane server on Linux.


Verify your system meets hardware and software requirements.

This includes setting up permissions, opening ports, database configuration, and more.

You need three separate server machines. 

  • ALM Octane server

  • Database server

  • Elasticsearch server

For details see Prerequisites, and Best practices in the ALM Octane Help Center.

Note: We recommend you review security considerations in ALM Octane 15.x Secure Deployment and Configuration Guidelines. This contains instructions on how to set up a secure configuration for ALM Octane.

Back to top


Deploy ALM Octane on a machine dedicated for the ALM Octane server on Linux.

ALM Octane is deployed using the RPM Package Manager (as an .rpm file).

The deployment path is /opt/octane.

The command to deploy is: rpm -Uvh <name of the RPM file>

For details see Deploy ALM Octane, and Best practices for deploying ALM Octane in the ALM Octane Help Center.

Back to top


This section describes how to configure.

To configure:

  1. Edit the octane.conf file with your site's settings for initial configuration.

  2. (Optional) Depending on your needs, configure optional configuration files:

    • elasticsearch-security.conf to configure secure Elasticsearch.
    • proxy.conf to use a proxy server.
    • ldap.conf to use LDAP authentication.
    • sso.conf to use SSO authentication.

    The path to these files is /opt/octane/conf.

For details, see Configure site settings.

Back to top

Start the server

Start the ALM Octane server: 

systemctl start octane

For details, see Start the ALM Octane server.

Back to top

Log in

Verify that ALM Octane was properly installed. For details, see Checking logs.

Log into ALM Octane. For details, see Log in to ALM Octane.

Back to top

Configure cluster (optional)

After starting the server on the first machine, configure and initialize each additional cluster node. For details, see Cluster installation flow.

Back to top

Next steps: