How to log in and go ACTIVE on vdremote.php

Logging into vdremote.php is a short process: open the page at your server's address, sign in with your VICIdial credentials, change the Status field from INACTIVE to ACTIVE, and click SUBMIT. Once that goes through, the dialer treats you as a live Remote agent and starts sending calls to your External Extension — the phone number the system dials to reach your physical device. When you are done for the day, you reverse the same step and the dialer stops routing to you.

What must be in place before you log in

Two things must be set up before you try to open vdremote.php. First, your VICIdial user account must be at level 4 or higher. Accounts below level 4 are not permitted to authenticate through the vdremote.php login page — the system will reject the attempt. Second, the admin must have already created a Remote Agent record pointing at your User ID and listing an External Extension. That record is what tells the dialer which phone number to dial when calls are routed to you. If either of those pieces is missing, talk to whoever manages your VICIdial admin panel before continuing.

Steps to log in and go ACTIVE

• Open a browser on any device and go to http://your-server-address/vicidial/vdremote.php. Replace your-server-address with the IP or hostname of your VICIdial server. The admin can give you this URL if you do not have it.
• Enter your VICIdial User ID and password. These are the same credentials you use for other VICIdial logins. The account must be at level 4 or higher or the page will refuse the login.
• Once logged in, find the Status field. It shows INACTIVE by default. Change it to ACTIVE.
• Click SUBMIT. The page will update to reflect the change. From this point your Agent session is registered as ready, and the dialer will route calls to your External Extension when it is your turn in the queue.

The login and activation flow

flowchart TD
  A["Open vdremote.php in browser"] --> B["Enter User ID and password"]
  B --> C{"User level 4 or higher?"}
  C -->|No| D["Login blocked - contact admin"]
  C -->|Yes| E["Login succeeds - Status shows INACTIVE"]
  E --> F["Change Status to ACTIVE"]
  F --> G["Click SUBMIT"]
  G --> H["Dialer routes calls to External Extension"]
  H --> I["End of shift - set Status to INACTIVE and SUBMIT"]
  I --> J["Allow up to 1 minute for deactivation"]

Going INACTIVE at the end of your shift

When your shift ends, go back to vdremote.php, change Status to INACTIVE, and click SUBMIT again. The Campaign will stop routing calls to your External Extension, but this does not happen at the exact moment you click. Deactivation can take up to one minute to propagate through the system. Do not assume calls have stopped the instant you submit — wait out the full minute before stepping away from your phone if timing matters.

The same one-minute lag applies in reverse when you first go ACTIVE. The dialer may take a short time before your Extension appears as available in the routing queue. If no calls arrive immediately after you activate, that is normal — wait a moment before assuming something is wrong.

For context on what vdremote.php shows during a live call and how dispositions work from that page, see remote agent status ACTIVE and INACTIVE explained. The full picture of how remote agents are configured is in the remote agents and mobile guide. To skip building the server yourself, managed VICIdial plans give you a fully configured dialer in under 40 seconds.