Installation Wizard

The interactive wizard guides you through configuration. Here's what happens at each step.

Step 1: System Check

The installer verifies your environment:

[1/4] System Check
══════════════════════════════════════════════════════

OS:        Ubuntu 22.04 LTS           ✓
Arch:      x86_64 (amd64)             ✓
CPU:       4 cores                    ✓
RAM:       8 GB                       ✓
Disk:      47 GB free                 ✓
Docker:    24.0.7                     ✓

Auto-Detection

The installer automatically detects:

Detection	Source	Result
PBX Type	Config file locations	FreePBX, Sangoma, Issabel, VitalPBX
MySQL Credentials	`/etc/freepbx.conf`, `/etc/issabel.conf`, etc.	Auto-filled in Step 3
OS Version	`/etc/os-release`	Compatibility check
Docker	System check	Auto-install if missing

On FreePBX/Sangoma systems, MySQL credentials are extracted automatically from /etc/freepbx.conf. No manual entry needed.

If Docker is Missing

The installer offers to install Docker automatically:

Docker not found. Install Docker? [Y/n]

Selecting Y runs the official Docker installation script.

Step 2: License Validation

Enter your license key:

[2/4] License
══════════════════════════════════════════════════════

Enter license key: asp-xxxx-xxxx-xxxx

Validating... ✓

License: Trial
Operators: 5
Expires: 2024-02-15

License Types

Type	Operators	Duration
Trial	5	14 days
Starter	10	Subscription
Professional	25	Subscription
Enterprise	Unlimited	Subscription

Trial licenses require internet access for validation. Production licenses work offline after initial activation.

Skip License Prompt

Provide the license key via command line:

sudo ./astervis-installer install --license "asp-xxxx-xxxx-xxxx"

Step 3: Configuration

Configure credentials and settings:

[3/4] Configuration
══════════════════════════════════════════════════════

Admin username [admin]:
Admin password [auto-generated]:
Admin email: admin@company.com

Domain/IP [192.168.1.100]: pbx.company.com

MySQL Settings

If not auto-detected, you'll be prompted:

MySQL Configuration
───────────────────
Host [localhost]:
Port [3306]:
Database [asteriskcdrdb]:
Username [asteriskuser]:
Password: ********

Auto-detected from /etc/freepbx.conf:

Host: localhost
Database: asteriskcdrdb
Credentials: From FreePBX config

SSL Certificate

Choose certificate type:

SSL Certificate
───────────────
[1] Self-signed (quick, requires browser exception)
[2] Let's Encrypt (requires valid domain, ports 80/443)
[3] Custom (provide your own certificate)

Select [1]:

Option	Best For	Requirements
Self-signed	Testing, internal use	None
Let's Encrypt	Production	Domain pointing to server, ports 80/443 open
Custom	Enterprise	Your certificate files

Step 4: Installation

The installer deploys Astervis:

[4/4] Installation
══════════════════════════════════════════════════════

Pulling images...
  database       [████████████████████] 100%
  cache          [████████████████████] 100%
  sync           [████████████████████] 100%
  api            [████████████████████] 100%
  dashboard      [████████████████████] 100%
  proxy          [████████████████████] 100%

Starting services...       ✓
Configuring sync...        ✓
Running migrations...      ✓
Importing operators...     ✓

Installation complete!

What Gets Installed

Component	Location
Docker Compose	`/opt/astervis/docker-compose.yml`
Configuration	`/opt/astervis/.env`
Data	`/opt/astervis/data/`
Logs	`docker logs astervis-*`

Real-time Sync Setup

The installer automatically:

Enables MySQL binary logging (if needed)
Creates a replication user
Configures sync connector
Starts initial data import

Initial CDR import happens after installation. Depending on CDR table size, this may take a few minutes.

Next: Post-Installation — verify services and access the dashboard

Installation Wizard

On this page