VICIfast

VICIdial scratch install / Debian 12

VICIdial scratch install on Debian 12

One command installs stock VICIdial r4035 on Debian 12: Asterisk 22 built for Debian 12, PHP 8.3 from packages.sury.org (Debian 12 ships 8.2), MariaDB 10.11, Apache with mod_php, a firewall and, by default, a campaign with fronters and closers ready to log in. It took 3m 20s on a 4-core server.

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

to a working dialer on Debian 12
3m 20s
from packages.sury.org (Debian 12 ships 8.2)
PHP 8.3
sized to the server’s memory and cores
MariaDB 10.11

Configure

The command for Debian 12

Set for Debian 12, 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 Debian 12 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 Debian 12

about 3 minutes

  1. 1

    Get your install key

    Keys are given out one an hour.

    Next key in 30:12

    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

Debian 12

What the installer does on Debian 12

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

  • Debian 12 ships PHP 8.2, so PHP 8.3 comes from packages.sury.org, Debian’s PHP maintainer’s own repository.
  • Measured the fastest install of the tested systems.
  • 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 Debian 12, 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 Debian 12
PHPPHP 8.3 from packages.sury.org (Debian 12 ships 8.2)
DatabaseMariaDB 10.11
Web serverApache with mod_php
Firewallufw with ipset
Install time3m 20s 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 Debian.

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.

FAQ

Questions, answered straight

Yes. The installer puts stock VICIdial r4035 on Debian 12 (bookworm) with PHP 8.3 from packages.sury.org, Debian’s MariaDB 10.11 and Asterisk 22.5.1-vf1 built for Debian 12.

Either: the installer does the same on both, and both are tested on every release. Debian 12 was the fastest install in our test runs; Ubuntu 24.04 takes PHP 8.3 from Ubuntu itself rather than a separate repository.

3m 20s 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.