telephony
Conf file
A conf file is an Asterisk configuration text file that defines settings like trunks, extensions, and dialplans, telling the phone system how to behave.
A conf file is simply a configuration file used by Asterisk, the open-source phone engine under VICIdial. The name comes from the .conf extension on the files. Each one is plain text full of settings, and together they tell the system everything from how to reach a carrier to which sound to play when a call enters a queue. If you have ever edited a settings file in a text editor, a conf file feels familiar: lines of options, the occasional comment, and section headers in square brackets that group related settings together.
Different conf files cover different jobs. One defines your SIP (Session Initiation Protocol) connections, another lays out the Dialplan that routes calls step by step, and another lists each Extension on the system. A trunk-related conf file holds the login details for your Trunk so Asterisk knows how to hand calls to the outside world. Each file is read when Asterisk starts up or when you ask it to reload, which means a change does nothing until that reload happens.
Why you rarely edit them by hand in VICIdial
Here is the part that trips up newcomers: in a VICIdial setup, you usually should not edit the conf files directly. VICIdial generates many of them for you from the web admin and the database behind it. A background Keepalive process rebuilds these files on a schedule, so any manual change you make can be silently overwritten on the next pass. People lose hours to this, editing a file, restarting, seeing it work, then watching it revert minutes later. That overwrite is a feature, not a bug, because it keeps thousands of moving parts in sync across the system.
When you do need a custom tweak, the safe path is to find the matching setting in the web interface or to use the files Asterisk treats as user-editable and never regenerates. Knowing which conf files are auto-generated and which are safe to touch is one of the most useful skills for keeping a stable dialer, and it saves you from chasing changes that keep disappearing.
Related terms
Asterisk
Asterisk is the open-source telephony engine that VICIdial runs on, handling the actual placing, bridging, and recording of calls beneath the dialer's logic.
Dialplan
The set of rules in Asterisk that decides what happens to each call, matching the dialed number and sending it to the right place step by step.
Extension
An extension is a short internal number that identifies a single phone, agent, or destination inside a PBX so calls can be routed to it.
Keepalive
A keepalive is a small repeated signal or background process that confirms a connection or service is still alive and triggers a fix when it goes quiet.
SIP (Session Initiation Protocol)
The standard signaling protocol that sets up, manages, and ends internet phone calls — how VICIdial talks to phones and carriers.
Trunk
The connection between your VICIdial server and your phone carrier that actually carries calls in and out of the system.