Installing VICIdial from the ViciBox ISO

The ViciBox ISO is the most common way people get a working VICIdial server without compiling everything by hand. It is a bootable installer image built on openSUSE, with the right Asterisk version and the VICIdial code already packaged. You burn it, boot it, and answer a few prompts instead of building the stack piece by piece.

What the image bundles

The ISO ships the operating system, a matched build of Asterisk, the VICIdial application, and the supporting tools all in one. Because the Asterisk version is preselected and pretested against the VICIdial code, you avoid the version-mismatch headaches that bite scratch installs. The web app, the background Perl scripts, and the default Conf file templates are laid down for you during setup.

The install flow

You boot the ISO, install the base operating system, then reboot into it and run the ViciBox installer to finish the dialer setup. There are two common paths. The standard install asks you a series of questions about networking and roles. The express install picks sane defaults and gets a single-server box running with far fewer prompts, which is what most first-time single-server users want.

Before you run either path, get networking sorted: a fixed IP, a working hostname, and an open path to the internet. The installer writes the server address into config in several places, and changing it afterward is more annoying than setting it right the first time. If the box is behind a router doing network address translation, note that early, because it affects how audio reaches your agents and how your carrier reaches you.

flowchart TD
  A[Burn ISO to USB] --> B[Boot installer]
  B --> C[Install base OS]
  C --> D[Reboot into system]
  D --> E[Run ViciBox install]
  E --> F[Express install single server]
  E --> G[Standard install with prompts]
  F --> H[Keepalive starts the dialer]
  G --> H

What still needs your attention

The ISO gives you a running stack, but it cannot finish the job for you. The Keepalive crontab is configured during setup and it is what launches and watches the dialing engine, so confirm those jobs are present and running before you blame the dialer. You will also set the server IP and roles so the box knows how to address itself.

Beyond the box, you still bring your own voice connection. You add a Server trunk entry that tells Asterisk how to reach your provider, supply the SIP (Session Initiation Protocol) credentials for that connection, and point a campaign at it. The ISO never includes a carrier or minutes; that part is always on you.

When the ISO is the right choice

The ISO route is a good fit when you control the hardware, want a known-good Asterisk pairing, and are comfortable on the Linux command line for the parts that remain. It saves you the longest and most error-prone step of a scratch build, the Asterisk compile. It is less ideal if your provider only offers a different base OS image, or if you want to layer the dialer onto an existing server you cannot wipe. For that, a from-scratch build on your own distribution may suit you better.

To see where the ISO sits among all the install options, read our complete VICIdial install guide. If you would rather build on plain Ubuntu instead, see installing VICIdial from scratch on Ubuntu.

Prefer not to manage an ISO, an OS, and a carrier setup at all? VICIfast provisions a secured, branded VICIdial server in under 40 seconds, with the carrier connection you choose wired in. See VICIfast pricing.