ViciBox is the official installation image for VICIdial — an openSUSE-based ISO that lays down the operating system, Asterisk, database, and dialer software in one guided install. The official download lives at download.vicidial.com, and the current documentation lives at docs.vicibox.com. Those two URLs matter more than they should, because the ViciBox web presence is a genuine version-number minefield — which is where this guide starts.
SIPNEX is an FCC-licensed carrier for VICIdial operations; we wrote this because half of new customers arrive mid-install. Background on the platform itself is in our VICIdial explainer.
Step 0: Don’t trust the first version number you see
When we surveyed the project’s own pages in August 2026, vicibox.com’s homepage showcased a release from 2019, a still-live walkthrough page described a release candidate from years earlier, and the actual current documentation at docs.vicibox.com covered ViciBox 12 on openSUSE Leap — three different eras on one domain. 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, and treat any other page — including well-ranked walkthroughs describing ancient releases — as historical. That rule covers the VICIdial download itself, too: the dialer’s source releases and the ViciBox ISOs share the same official download host — 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 new VICIdial deployments.
What you need before booting
- Hardware: a dedicated x86 server — the dialer stack expects real resources and low-latency disk. Virtualization works for labs; production floors favor bare metal.
- A static IP on your network — the installer expects one, and your carrier trunks will be locked to it later.
- Network basics decided: hostname, domain, timezone, and DNS before you start, not during.
- A plan for swap: project guidance sizes swap relative to RAM — have disk budgeted for it.
The install, at ten thousand feet
Modern ViciBox installs run in phases (the current docs at docs.vicibox.com are the authority for your exact version):
- Boot the ISO and install the OS. Choose the ViciBox server install; configure language, keyboard, network with your static IP, timezone, and partitioning; set the root password; reboot into the fresh openSUSE-based system.
- Run the VICIdial installation phase. Log in as root and run
vicibox-install— the express path configures a single all-in-one server; custom paths split database, web, and dialer roles across machines for clusters.
Then the dialer itself:
- Confirm the web interfaces answer. Admin and agent interfaces come up under your server’s address; log in, change every default credential immediately, and verify 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, and it’s where our VICIdial SIP trunk setup guide takes over: the sip.conf carrier block, registration, 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%. What separates a floor that connects from one that burns lists: pacing tuned to your answer rates (predictive dialing explained), abandonment kept inside FCC limits, caller-ID hygiene managed from day one (reputation guide), and a carrier signing your calls at A-level attestation 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 installation CD/image for the VICIdial contact center suite — an openSUSE-based ISO that installs the operating system, Asterisk, database, web server, and VICIdial software in one guided process. It exists so deployments don’t hand-assemble the LAMP-plus-Asterisk stack; the express install path can configure 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, referenced by ViciBox’s own documentation. Pair it with the current documentation 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 frequently describe obsolete installers. Verifying you have the current ISO before booting saves the most common false start in VICIdial deployment.
What operating system does ViciBox run on?
ViciBox is built on openSUSE — as of August 2026, current documentation covers ViciBox 12 on openSUSE Leap — with the dialer stack (Asterisk, MySQL/MariaDB, Apache, VICIdial) layered on top by the installer. You don’t install openSUSE separately; the ViciBox ISO handles the OS and the application stack in one process, which is precisely why it’s the recommended path over manual installation on a generic distribution.
What are the ViciBox default login and password?
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 — and the VICIdial web administration interface defaults to user 6666 with password 1234, which the docs suggest granting 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, documented at docs.vicibox.com — and nothing older. Our survey of the project’s own web pages found releases from three different eras still displayed on live pages, so a version number from a search result or an old homepage is unreliable. Check the official download host at install time; on a system as security- and telephony-sensitive as a dialer, installing a years-old image is not a shortcut worth taking.
Get the ISO from the official host, follow the current docs, then give the dialer 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.