VICIfast

VICIdial scratch install / Ubuntu 22.04

VICIdial scratch install on Ubuntu 22.04

One command installs stock VICIdial r4035 on Ubuntu 22.04: Asterisk 22 built for Ubuntu 22.04, PHP 8.3 from the ondrej/php PPA (Ubuntu 22.04 ships 8.1), MariaDB 10.6, Apache with mod_php, a firewall and, by default, a campaign with fronters and closers ready to log in. It took 4m 15s on a 4-core server.

Last tested on a fresh Ubuntu 22.04 server on 3 November 2026. Free and open source under the GPL, from the VICIfast team.

Build your Ubuntu 22.04 command
to a working dialer on Ubuntu 22.04
4m 15s
from the ondrej/php PPA (Ubuntu 22.04 ships 8.1)
PHP 8.3
sized to the server’s memory and cores
MariaDB 10.6

Configure

The command for Ubuntu 22.04

Set for Ubuntu 22.04, with the firewall, the production fixes, dial-level control and the initial setup (10 fronters, 5 closers) included. Change any of them, then paste the line into a fresh Ubuntu 22.04 server as root.

PHP 8.3, VICIdial r4035
Point its A record at the server first. Empty: the server’s IP.
For certificate notices.

Included by default

Logins from 1001.
Logins from 2001. Blank: one per two fronters.
Calling hours follow this clock.
Web and phones open; SIP only from the allow list.
Your carrier’s addresses: SIP stays closed to everyone else.

On Ubuntu 22.04

about 4 minutes

  1. 1

    Get your install key

    Keys are given out one an hour.

    Next key in 30:05

    Free. One key per email and one key an hour; each key installs one server, the first one that uses it.

  2. 2

    If the server has no curl yet

    apt-get update && apt-get install -y curl
  3. 3

    Run the installer as root

    curl -fsSL https://downloads.vicifast.com/vicidial-installer/install.sh |
  sudo bash -s -- \
  --key YOUR-INSTALL-KEY \
  --with-fixes \
  --initial-setup \
  --fronters 10 \
  --closers 5
    Rather read the script before it runs?
    curl -fsSLO https://downloads.vicifast.com/vicidial-installer/install.sh
less install.sh
sudo bash install.sh --key YOUR-INSTALL-KEY --with-fixes --initial-setup --fronters 10 --closers 5

When it finishes

  • Admin: https://SERVER-IP/vicidial/admin.php, user 6666
  • Passwords: /root/vicifast-credentials.txt, the agents’ too
  • Agents: https://SERVER-IP/agc/vicidial.php, campaign TESTCAMP, user and password only
  • Everything at a glance: vicifast status

Ubuntu 22.04

What the installer does on Ubuntu 22.04

The parts of a VICIdial scratch install that are particular to Ubuntu 22.04, and that a by-hand install has to get right.

  • Ubuntu 22.04 ships PHP 8.1, so PHP 8.3 comes from the ondrej/php PPA, the same maintainer who packages PHP for Debian, with security fixes backported.
  • MariaDB is Ubuntu 22.04’s own 10.6, sized to the server’s memory and cores.
  • AppArmor is removed, as VICIdial’s own Ubuntu instructions do: its daemons, AGIs and web code write across /etc/asterisk, /var/lib/asterisk and /var/spool/asterisk, and a confining profile breaks them.

At a glance

VICIdial on Ubuntu 22.04, part by part

VICIdialVICIdial r4035, stock, from its official SVN
Asterisk22.5.1-vf1 (22.5.1 with the 22 branch’s security fixes), built for Ubuntu 22.04
PHPPHP 8.3 from the ondrej/php PPA (Ubuntu 22.04 ships 8.1)
DatabaseMariaDB 10.6
Web serverApache with mod_php
Firewallufw with ipset
Install time4m 15s measured on 4 vCPU / 8 GB, every option on
If curl is missingapt-get update && apt-get install -y curl

Rather do it by hand?

Every step, explained: Installing VICIdial from scratch on Ubuntu.

Everything else

Every option, the firewall modes, the commands for afterwards and what to do if an install stops are on the VICIdial scratch install page.

Other systems

The same install on another system

VICIdial on Ubuntu 24.04

4m 24s measured

VICIdial on Debian 12

3m 20s measured

VICIdial on Rocky Linux 9

4m 20s measured

VICIdial on AlmaLinux 9

4m 03s measured

FAQ

Questions, answered straight

Yes. The installer puts stock VICIdial r4035 on Ubuntu 22.04 with PHP 8.3 from the ondrej/php PPA, Ubuntu’s MariaDB 10.6 and Asterisk 22.5.1-vf1 built for 22.04. With --php 7.4 it installs PHP 7.4 and VICIdial r4032 instead.

Yes: add --php 7.4 and the installer uses PHP 7.4 from the same PPA with VICIdial r4032, the revision written for it. PHP 7.4 no longer gets fixes from PHP itself, so 8.3 is the default.

4m 15s from the start of the install to a working dialer, measured on a fresh 4 vCPU / 8 GB server with every option on and the prebuilt Asterisk. Compiling Asterisk on the server instead adds up to 3 minutes.

Run the same command again. It resumes at the stage that failed and keeps the passwords and options it already chose.

Need a migration from another host or a custom contract? Talk to VICIfast.