ViciBox is the official install image for VICIdial. It is an openSUSE-based ISO that lays down the operating system, Asterisk, the database, and the dialer software in one guided install. The official download lives at download.vicidial.com, and the current docs live at docs.vicibox.com. Those two URLs matter more than they should. The ViciBox web presence is a real version-number minefield, and that is where this guide starts.
SIPNEX is an FCC-licensed carrier for VICIdial operations. We wrote this guide for teams that arrive mid-install. Background on the platform itself is in our VICIdial explainer.
Step 0: Don’t trust the first version number you see
We surveyed the project’s own pages in August 2026. The vicibox.com homepage showcased a release from 2019. A still-live walkthrough page described a release candidate from years earlier. The current docs, on the same domain, covered ViciBox 12 on openSUSE Leap. That is three different eras on one domain, and community forum threads referenced newer point releases still.
The practical rule: get your version and ISO from download.vicidial.com, and your instructions from docs.vicibox.com. Treat any other page as history, including well-ranked walkthroughs that describe ancient releases. The same rule covers the VICIdial download itself. The dialer’s source releases and the ViciBox ISOs share one official download host, and our VICIdial download and login guide maps the folders and the post-install login pages. Installing from a stale ISO is the most common self-inflicted wound in a new VICIdial deployment.
What you need before booting
- Hardware: a dedicated x86 server. The dialer stack expects real resources and low-latency disk. Virtual machines work for labs; production floors favor bare metal.
- A static IP on your network. The docs call it highly recommended rather than required, and your carrier trunks will be locked to it later.
- Network basics decided: hostname, domain, timezone, and DNS — before you start, not during.
- A disk you can wipe: the ViciBox installer takes the whole target drive, and there is no partitioning step. Back up anything on it first.
The install, at ten thousand feet
Modern ViciBox installs run in phases. The result is the full VICIdial call center suite on one box or across a cluster. The current docs are the authority for your exact version.
- Boot the ISO and install the OS. Choose Install ViciBox and select the target disk — the installer wipes it. After the first boot, log in as root. The first-login wizard asks for localisation, keyboard, the license, timezone, and a root password. Then reboot. Set the static IP next with
yast lan(the docs’ Phase 1.5). - Run the VICIdial install phase. Log in as root. Run
vicibox-expressfor a single all-in-one server, orvicibox-installfor the custom wizard that splits the database, web, and telephony roles across machines for clusters.
Then the dialer itself:
- Confirm the web interfaces answer. The admin and agent screens come up under your server’s address. Log in, change every default credential at once, and check that Asterisk is registering.
- Configure carrier, campaign, and agents. The dialer is installed but silent until a trunk exists. Carrier config, DIDs, a campaign, a list, and an agent get you to first call.
Step 4 is its own discipline. It is where our VICIdial trunk setup guide takes over: the sip.conf carrier block, registration, the dial plan, and the codec choice our G.711 versus G.729 comparison settles.
After first call: the settings that decide performance
Installation is the easy 20%. Four things separate a floor that connects from one that burns lists:
- Pacing tuned to your answer rates — see predictive dialing explained.
- Abandonment kept inside FCC limits.
- Caller-ID hygiene managed from day one — see the reputation guide.
- A-level attestation on every call, so analytics engines trust your traffic.
That last item is bought, not configured. It comes from a carrier with its own STIR/SHAKEN certificate. Our VICIdial carrier lane was built for exactly this, with published rates.
Frequently asked questions
What is ViciBox?
ViciBox is the official install CD/image for the VICIdial contact center suite. It is an openSUSE-based ISO that installs the operating system, Asterisk, the database, the web server, and the VICIdial software in one guided process. It exists so you don’t hand-assemble the LAMP-plus-Asterisk stack. The express install path can set up a complete single-server dialer, while custom paths support multi-server clusters.
Where do I download ViciBox?
From download.vicidial.com, the project’s official download host. ViciBox’s own documentation points there. Pair it with the current docs at docs.vicibox.com and ignore version numbers found elsewhere. The project’s older web pages still display releases from years past, and third-party walkthroughs often describe obsolete installers. Check that you have the current ISO before booting; it saves the most common false start in a VICIdial deployment.
What operating system does ViciBox run on?
ViciBox is built on openSUSE. As of August 2026, the current docs cover ViciBox 12 on openSUSE Leap. The installer layers the dialer stack — Asterisk, MySQL/MariaDB, Apache, and VICIdial — on top. You don’t install openSUSE separately. The ViciBox ISO handles the OS and the application stack in one process, which is why it is the recommended path over a manual install on a generic distribution.
What are the ViciBox default login and password?
There are two documented defaults, straight from docs.vicibox.com. The OS installer offers to keep ViciBox’s default root password, vicidial, or set your own — set your own. The VICIdial web admin interface defaults to user 6666 with password 1234, and the docs suggest granting that user full admin permissions during setup. Change both before the server touches production traffic. A dialer with stock credentials on a public IP gets found fast.
Which ViciBox version should I install?
Whatever download.vicidial.com currently offers as stable, and the current docs describe — nothing older. Our survey of the project’s own web pages found releases from three different eras still displayed on live pages. A version number from a search result or an old homepage is unreliable. Check the official download host at install time. A dialer is security- and telephony-sensitive, so installing a years-old image is not a shortcut worth taking.
Get the ISO from the official host and follow the current docs. Then give the call center suite a carrier worthy of it: VICIdial trunking with published rates and A-level attestation — (833) 665-2220.
Keep reading.
The carrier built by operators, for operators.
FCC-licensed carrier with its own STIR/SHAKEN SP certificate. Operator-owned. SIP trunks built for operators who dial at volume.