Vicidial Complete Guide

Everything you need to know about Vicidial — the world's most popular open-source contact center platform built on Asterisk

10
In-Depth Guides
12+
Key Capabilities
100%
Open Source

What is Vicidial?

Vicidial(often stylized as VICIdial) is the world's most widely used open-source contact center suite. Built on top of the Asterisk PBXframework, it provides a full-featured predictive dialer, automatic call distribution (ACD), interactive voice response (IVR), and comprehensive agent management — all through a web-based interface.

Originally created by Matt Florell in 2003, Vicidial has grown into a mature platform used by thousands of call centers worldwide. It is released under the AGPLv2 license, meaning the source code is freely available, and organizations can modify, deploy, and extend it without per-seat licensing fees.

The Vicidial community is active and supportive, with an official forum (www.vicidial.org), regular SVN updates, and a dedicated IRC/Slack channel. Commercial support is available from the Vicidial Group and various third-party integrators.

Key Capabilities

Predictive Dialing
Blended Campaigns
ACD Routing
IVR / Call Menus
Call Recording
Real-Time Reports
Multi-Tenant
Remote Agents
WebRTC Support
DNC Management
Scripting Engine
Skills-Based Routing

Architecture Overview

Vicidial's architecture consists of several tightly integrated components working together:

ASTERISK PBXSIP / IAX2 / DAHDIMySQL / MariaDBasterisk + vicidial DBsApache + PHPWeb Admin & Agent UIPerl ScriptsDialer, Listener, KeepaliveWeb AgentsBrowser-based UISIP PhonesSoftphone / HardphonePSTN / CarriersSIP Trunks
  • Asterisk PBX — The telephony engine handling all SIP/IAX2 calls, codec negotiation, and media.
  • MySQL / MariaDB — Stores all configuration, lead data, call logs, recordings metadata, and real-time data.
  • Apache + PHP — Serves the admin panel and agent web interface (agc/vicidial.php).
  • Perl Scripts — Background daemons that power the dialer engine (AST_VDauto_dial), call routing (AST_VDremote_agents), keepalive processes, and more.

System Requirements

ComponentMinimumRecommended (50+ agents)
OSCentOS 7 / Rocky 8Rocky Linux 8 or 9 / AlmaLinux 9
CPU2 cores / 2 GHz8+ cores / 3 GHz+
RAM4 GB16 GB+
Storage50 GB HDD500 GB+ SSD (for recordings)
Network100 Mbps1 Gbps dedicated
AsteriskAsterisk 16+Asterisk 18 or 20 LTS
DatabaseMySQL 5.7 / MariaDB 10.3MariaDB 10.6+
PHPPHP 7.4PHP 8.1+

Common Use Cases

Call Centers

High-volume inbound and outbound operations with predictive dialing.

Telemarketing

Automated outbound campaigns with script pop-ups and lead management.

Surveys & Polling

Phone-based surveys with disposition tracking and data collection.

Customer Service

Inbound queues with skills-based routing and hold-time announcements.

Collections

Debt collection campaigns with compliance features and callbacks.

Political Campaigns

Voter outreach, robocalling (where permitted), and volunteer management.

Vicidial vs Commercial Solutions

FeatureVicidial (Open-Source)Commercial Dialers
License CostFree (open-source, AGPLv2)$50–$300+ per agent/month
Source Code AccessFull access — modify anythingClosed source, vendor-locked
Predictive DialerBuilt-in, highly configurableIncluded in higher tiers
ScalabilityScales with hardware (100s of agents)Cloud-based, pay-per-seat
CustomizationUnlimited — Perl/PHP scriptsLimited to vendor APIs
SupportCommunity + paid support optionsVendor SLA included
HostingSelf-hosted (full control)Vendor-hosted (less control)
Setup ComplexityModerate — Linux admin skills neededLow — plug and play
WebRTCSupported (with config)Usually built-in
API AccessNon-Agent API + Agent APIREST APIs (varies)

Vicidial Setup Guides