Getting Started Guide

Overview

This guide helps you get started with Aerobase. It covers server configuration and use of the default database. Advanced deployment options are not covered. For a deeper description of features or configuration options, consult the other reference guides.

Installing and Booting

Edit this section Report an issue

This section describes how to boot a Aerobase server and log in to the Aerobase admin console. Aerobase takes just 2 minutes to install and is packaged in the popular deb / rpm / msi / docker formats.

Installing Distribution Files

Edit this section Report an issue

Download the Aerobase Server:

aerobase-26.6.4-1.[deb|rpm]
aerobase-iam-26.6.4-1.[deb|rpm]

These files can be downloaded from Aerobase downloads.

OpenJDK 21 is bundled with the Aerobase packages — a separate Java installation is not required.

Install packages

Red Hat Enterprise Linux / CentOS / Rocky Linux

$ sudo yum install ./aerobase-26.6.4-1.centos.rocky10.x86_64.rpm \
                   ./aerobase-iam-26.6.4-1.centos.rocky10.x86_64.rpm

For aarch64 hardware, use the .aarch64.rpm variants (e.g. aerobase-26.6.4-1.centos.rocky10.aarch64.rpm).

Ubuntu / Debian

$ sudo apt-get install ./aerobase_26.6.4-1.ubuntu_amd64.deb \
                       ./aerobase-iam_26.6.4-1.ubuntu_amd64.deb

For Debian, replace .ubuntu_amd64.deb with .debian_amd64.deb. For arm64 hardware, replace amd64 with arm64.

Windows

The Windows installer (aerobase-openjdk-<version>-x64.msi) is published in the legacy package archive at packages.aerobase.io/windows. PowerShell 5.1+ is required, and the sqlcmd utility is required for Microsoft SQL Server connectivity.

> msiexec.exe /i aerobase-openjdk-26.6.4-x64.msi

Configuring the external URL

Edit this section Report an issue

In order for Aerobase to properly validate oauth requests it needs to know the URL under which it is reached by your users, e.g. http://idp.aerobase.com. Add or edit the following line in /etc/aerobase/aerobase.rb:

external_url "http://idp.aerobase.com"

Any changes you make to this file while the server is running will not take effect. Run sudo aerobase-ctl reconfigure for the change to take effect.

Booting the Server

Edit this section Report an issue

To boot the Aerobase server, first run the aerobase-ctl configuration script:

Linux/Unix

$ aerobase-ctl reconfigure
$ aerobase-ctl start

Windows

> aerobase-ctl.bat reconfigure

Enabling HTTPS will require additional configuration to specify the certificates.

Logging in to the Admin Console

Edit this section Report an issue

After you create the initial admin account, use the following steps to log in to the admin console:

Click the Administration Console link on the Welcome page or go directly to the console URL http://localhost/auth/admin/aerobase/console
Type the default username and password (admin/123).

Admin Console

Updating Aerobase

Edit this section Report an issue

Depending on the installation method and your Aerobase version, there are multiple update guides.

There are currently 2 official ways to install Aerobase:

Omnibus packages
Docker installation

Omnibus Package Upgrade

Make sure to backup your database before starting any upgrade process

Stop aerobase services aerobase-ctl stop
Install new package Distribution Files
run aerobase-ctl reconfigure
Start all services aerobase-ctl start

Installation using Docker

Edit this section Report an issue

Aerobase provides official Docker images. They are based on the Omnibus package and instructions on how to update them are in a separate document.