First pairing

Join your tenant network with a join code and go live on VMGateServer.

Get a join code

Your administrator generates a code in the portal under Join Codes for the target Network. Codes look like VMG-XXXX-XXXX and are network-specific — a code from the wrong network attaches the phone to the wrong pool.

Portal steps are in VMGateServer manual chapter 04. Complete chapter 03 (APK installed, VMGate Audio, flashed board connected) before entering a code.

Create a profile

On the phone:

  1. Open VMGateClient. If you see No profile yet, tap Create a profile. Otherwise open menu → Profiles and tap Add profile (+).
  2. Enter a short name (for example the site or network name).
  3. Paste the join code from your administrator.
  4. Tap Save. The app contacts VMGateServer and validates the code — wait for Resolving join code… to finish. Invalid or expired codes show an error; ask your administrator for a new code.

Connect the profile

From the profile list, tap your new profile, then tap Connect and confirm the switch.

If prompted, open the license agreement, read it, and tap I accept — you cannot connect without accepting the current license version.

The app joins the VMGate network for that profile. Keep mobile data or Wi‑Fi active; captive portals and strict firewalls can block registration.

Enable termination

On the main screen, turn on Termination enabled. When this is off, the phone does not take call assignments from VMGateServer even if it is online.

If Android asks to set the default phone app, choose VMGateClient (chapter 03). Without that, GSM calls from VMGate will not work.

Confirm the status line shows VMGateServer: ✓ connected. SIM 1 / SIM 2 cards should appear; enable each slot you want to use for traffic (see chapter 05).

Portal check and test call

In the portal, open VMGateClients for the same network. The device should appear after a valid join code — there is no separate approve step in the portal.

Check the Status column: ready means the client can take traffic; no_dongle means connect the flashed board and allow USB access (chapter 03).

Before production traffic, place a test call from your lab Customer trunk and confirm audio both ways. Policy (caps, ring timeout, rates) is configured in the portal — see VMGateServer manual chapter 05.