Installation

Astervis installs via a single command. The installer handles Docker, databases, SSL, and real-time sync setup automatically.

Quick Start

Run this command on your server (replace with your license key):

curl -fsSL https://api.astervis.io/api/releases/install.sh | bash -s -- --license "your-license-key"

Get your installation command with license key pre-filled from your account dashboard.

The installer will guide you through configuration. You'll need:

Root/sudo access
MySQL CDR credentials (auto-detected on FreePBX)

First time? Check System Requirements before installing.

What Happens

The installer runs a 4-step wizard:

System Check — verifies OS, resources, Docker, PBX detection
License — validates your license key
Configuration — admin credentials, domain, MySQL settings
Installation — pulls images, starts services, configures sync

Total time: ~5 minutes (depending on internet speed).

Installation Options

Download Installer Manually

If you prefer to download the installer first:

# Download installer
curl -fsSL https://api.astervis.io/api/releases/install.sh -o install.sh
chmod +x install.sh
 
# Run with your license key
sudo ./install.sh --license "your-license-key"

Resume Failed Installation

If installation was interrupted:

sudo astervis-installer install --resume

After Installation

Once complete, you'll see:

══════════════════════════════════════════════════════
 ASTERVIS INSTALLATION COMPLETE
══════════════════════════════════════════════════════

 Dashboard: https://192.168.1.100:8443
 Username:  admin
 Password:  aB3xYz9wQ1

══════════════════════════════════════════════════════

Open the URL in your browser, accept the SSL warning (self-signed), and log in.

Next Steps

Wizard Details — detailed walkthrough of each configuration step

Post-Installation — verify services, access logs, first steps

Troubleshooting — common issues and solutions

Command Reference

# Check status
sudo astervis-installer status
 
# View logs
sudo astervis-installer logs --follow
 
# Upgrade to latest version
sudo astervis-installer upgrade
 
# Uninstall
sudo astervis-installer uninstall

Installation

On this page