Installing VICIdial from Scratch on Ubuntu

Building VICIdial from scratch on Ubuntu gives you the most control: your choice of Ubuntu release, your own partition layout, and a stack you understand because you built it. The tradeoff is that you do every step yourself, including the long part, compiling Asterisk. Here is the shape of the work.

Prerequisites

Start with a clean Ubuntu Server install on a dedicated box, with root access and a fixed IP. Install the build toolchain, MySQL or MariaDB, Apache or another web server, PHP, and a long list of Perl modules that the VICIdial scripts need. Missing Perl modules are the single most common reason the install script fails partway, so get them in early. You also want the development headers for the libraries Asterisk links against.

Pulling the source

You fetch two things: the Asterisk source for a version VICIdial is known to work with, and the VICIdial source itself. Use a matched Asterisk version rather than whatever is newest; a version that VICIdial has not been tested against can break call control or the MeetMe conference conference bridging that agent sessions depend on.

Compiling Asterisk

This is the slow step. You configure the Asterisk build, choose the modules you need, then compile and install. Pay attention to audio support here: if you want to dial efficiently you will enable the right Codec modules so calls do not transcode unnecessarily. Once Asterisk is installed you confirm it starts cleanly before going any further.

flowchart TD
  A[Clean Ubuntu install] --> B[Install deps and Perl modules]
  B --> C[Fetch Asterisk source]
  C --> D[Compile and install Asterisk]
  D --> E[Fetch VICIdial source]
  E --> F[Run install script]
  F --> G[Load database tables]
  G --> H[Enable keepalive crontab]

Running the install script

With Asterisk up, you run the VICIdial install script. It asks about your database and server details, creates the tables, copies the PHP pages and the Perl and AGI (Asterisk Gateway Interface) scripts into place, and writes the starting Conf file templates and Dialplan entries that connect VICIdial to Asterisk. Read the prompts carefully; a wrong answer here means editing config later.

Before you trust the install, set up the basics that Ubuntu does not do for you. Give the box a fixed IP and a real hostname, since VICIdial writes the server address into its own settings. Make sure the database is configured to start on boot and tuned for the load you expect, because a default database setup is fine for a test but tight for a busy floor. And get time synchronization running early, since accurate timestamps underpin every report the dialer produces.

Ubuntu gotchas

A few snags show up again and again. Apparmor or the firewall can block the web server or Asterisk ports until you adjust them. Newer Ubuntu releases rename or drop packages the older install expects, so a name that worked two releases ago may not exist now. Time and date handling matters too; an unsynced clock skews call timestamps and reports. And do not forget the crontab: the dialer will not place calls until the keepalive jobs are active.

For the wider context and where this path fits, see our complete VICIdial install guide. If a packaged route appeals more, compare it against installing from the ViciBox ISO.

If a full day of compiling and debugging is not how you want to spend the week, VICIfast hands you a ready, secured dialer in under 40 seconds. See VICIfast pricing.