VICIbox Installation Guide: Deploy VICIdial Fast
VICIbox is the shortest path from “empty server” to “working VICIdial call center.” Instead of hand-installing Linux, Asterisk, MySQL, Apache, PHP, and the VICIdial application — and then stitching them together — VICIbox does it all in a single automated install. This guide covers what it is, the server you need, and a step-by-step walkthrough.
What Is VICIbox?
VICIbox is an ISO image that combines openSUSE Linux, Asterisk, MariaDB (MySQL-compatible), Apache, PHP, and the full VICIdial contact center suite into a single bootable installer. It’s built and maintained by The Vicidial Group — the same team that maintains VICIdial itself.
When you boot a server from the VICIbox ISO, the installer lays down the OS, all dependencies, and VICIdial in a tested, production-ready configuration. At the end of the install, you reboot into a system that’s ready to configure campaigns and take calls.
Three reasons VICIbox is the recommended install method:
- Tested configurations. Dependency versions are vetted — no guessing whether your Asterisk and your MySQL schema line up.
- Predictable environment. Matches what most of the support community runs, so debugging and help are easier.
- Time savings. A manual install takes a full day or more; VICIbox installs in 30-45 minutes unattended.
VICIbox Server Requirements
Minimum for testing:
- 4 GB RAM
- 40 GB storage (SSD preferred)
- 2 CPU cores
- Dedicated server, KVM, or VMware VM (not OpenVZ)
Recommended for production (up to 50 agents):
- 8-16 GB RAM
- 100-200 GB SSD storage
- 4-8 CPU cores (physical preferred for Asterisk timing)
- Bare metal or KVM with CPU passthrough
- 100 Mbps network with low jitter
Why not OpenVZ or LXC? OpenVZ containers share the host kernel and often interfere with Asterisk’s real-time audio timing. Call quality degrades noticeably. KVM and VMware provide full virtualization and work fine.
For deployments over 50 agents you typically split the architecture: one database server, one web server, and one or more telephony servers. VICIbox supports cluster installs for this.
How to Download VICIbox
VICIbox is hosted on vicidial.org. Navigate to the downloads page and pick the current stable release. As of this writing, the latest is VICIbox v11 built on openSUSE 15.x with Asterisk 16/18.
Download both the ISO file and its checksum. Verify the checksum before writing to USB or mounting in your hypervisor — a corrupted ISO will fail in confusing ways mid-install.
Step-by-Step VICIbox Installation
1. Prepare your server. Provision your bare metal, KVM, or VMware machine with the RAM, CPU, and storage spec above. Confirm BIOS is set to boot from USB or ISO.
2. Create installation media. If installing on bare metal, write the ISO to a USB stick with Rufus (Windows) or dd (Linux/Mac). If installing in a hypervisor, attach the ISO directly to the VM’s virtual DVD drive.
3. Boot the installer. Boot from the ISO. The VICIbox boot menu appears. Select “VICIbox Server Install” (NOT the “Live” option — that one runs in memory and doesn’t persist).
4. Select install type. Choose single-server install for a standard deployment. Cluster installs are available for multi-server architectures.
5. Partitioning. Accept the default partitioning scheme for first-time installs. It sets up /, /var (where recordings live), and swap.
6. Set hostname and timezone. Pick a hostname (e.g., dialer1) and set the correct timezone — this matters for call time-of-day enforcement.
7. Set root password. Use a strong password. Write it down in your password manager.
8. Confirm and install. The installer runs unattended for 20-40 minutes depending on hardware. Watch for completion.
9. Reboot. Remove the ISO and reboot. The system boots into the installed OS.
10. Run the post-install script. Log in as root and run /usr/src/astguiclient/install.pl (or the current equivalent — VICIbox documentation always has the latest path). This script finalizes VICIdial configuration and seeds the database.
11. Access the admin interface. Open a browser to http://your-server-ip/vicidial/admin.php. Default credentials are documented in the VICIbox install output — change them immediately.
Post-Installation: First Steps After VICIbox Installs
Once VICIbox has delivered a working VICIdial system, do these first:
- Change all default passwords (admin, root, database)
- Update firewall rules — open 5060/UDP for SIP, 10000-20000/UDP for RTP, 80/443 for HTTP(S), and 22 for SSH
- Install a TLS certificate on Apache for the admin interface
- Configure your SIP trunk carrier in Admin > Carriers
- Create your first in-group (inbound queue) and campaign
- Set the correct timezone in system settings
- Configure backups of /etc/asterisk, /var/lib/mysql, and /var/spool/asterisk/monitor
For full configuration help, see our VICIdial admin guide, VICIdial campaign setup, and VICIdial agent login and setup guide walkthroughs.
Common VICIbox Installation Problems and Fixes
Installer can’t find disk. Usually a RAID driver issue. Check that your RAID controller is supported by openSUSE, or switch to AHCI passthrough.
Network not configured after install. Run yast lan to set static IP, gateway, and DNS. DHCP on a VICIdial server is not recommended.
Apache not starting. Check /var/log/apache2/error_log. Usually a permissions or port conflict with an old install.
Admin login fails with default creds. The install may have generated a new default — check the output log from install.pl for the current password.
No audio on calls. RTP port range not open in firewall, or NAT misconfigured. Open 10000-20000/UDP and configure Asterisk’s externip and localnet in sip.conf.
Should You Even Use VICIbox?
VICIbox is great. But it’s still a Linux server you have to own, patch, secure, back up, and monitor forever. Many call centers reach a point where they’d rather someone else handle that.
If you want to skip the installation entirely with hosted VICIdial, we handle the server, OS, patching, backups, and monitoring — you just log in and use it. If you prefer to own the server but want the install done right, our professional VICIdial installation service takes you from bare server to dialing in a few business days. For a broader walkthrough, see our how to install VICIdial post.
Frequently Asked Questions
What is VICIbox used for? VICIbox is used to install VICIdial automatically. It’s a pre-configured Linux ISO that lays down openSUSE, Asterisk, MariaDB, Apache, PHP, and the VICIdial application in one install, producing a working call center server in 30-45 minutes.
Can VICIbox run on a VPS? VICIbox can run on a VPS that uses KVM or VMware virtualization with dedicated CPU resources. OpenVZ and LXC-based VPS providers should be avoided because shared kernels disrupt Asterisk’s real-time audio timing. Most major cloud providers (AWS, GCP, Vultr, Linode) offer KVM-based instances that work fine.
What is the difference between VICIbox and a manual VICIdial install? VICIbox is an automated installer that sets up the entire stack from a single ISO. A manual install requires you to install Linux, then Asterisk, then MariaDB, then Apache/PHP, then VICIdial itself, and stitch them together by hand. Manual installs give more OS flexibility but take much longer and are harder to support.
How long does a VICIbox installation take? A VICIbox installation typically takes 30-45 minutes from inserting the ISO to a working system, depending on hardware speed. Post-install configuration (carriers, campaigns, users) adds another 1-4 hours depending on complexity.
Do I need Linux experience to install VICIbox? Basic Linux comfort helps. The ISO automates most of the install, but post-install tasks — firewall rules, TLS certs, backups, monitoring — assume you can work at the command line. If you’re not comfortable there, consider professional installation or hosted VICIdial.
Skip the Install: Consider Hosted VICIdial
Installing VICIbox yourself is entirely doable, but if you’d rather have a dialing-ready system in days with no Linux involvement, review our hosted VICIdial plans or reach out via the contact page.