VMGate Installation Guide

Version: 1.0
Date: November 29, 2025
Last Updated: November 29, 2025

---

---

PREREQUISITES

Required:

• ✅ Samsung device (A15, A16, A53, or A54)
• ✅ Android 13 or higher
• ✅ Device already rooted with Magisk v27.0 (recommended version)
• ✅ USB Debugging enabled
• ✅ VMGate APK file downloaded

Required Software:

• ✅ Magisk v27.0 - Download Magisk Manager → Download app-release.apk from the releases page
• ✅ Systemizer Module v17.3.1 - Direct Download (recommended) or GitHub Releases Page

Recommended:

• ✅ Full device backup
• ✅ Stable internet connection
• ✅ At least 50% battery charge

---

INSTALLATION METHODS

Method 1: Termux + Systemizer (RECOMMENDED - No Computer Required)

This method allows you to systemize VMGate directly on your phone without needing a computer.

Advantages:

• ✅ No computer required
• ✅ All steps done on phone
• ✅ Magisk module handles mount persistence
• ✅ Easier for most users

Disadvantages:

• ❌ Requires Termux app
• ❌ Requires Systemizer Magisk module

Method 2: ADB (Alternative - Requires Computer)

This method uses ADB commands from a computer to systemize VMGate.

Advantages:

• ✅ More control over process
• ✅ Can be automated with scripts

Disadvantages:

• ❌ Requires computer with ADB installed
• ❌ More complex commands
• ❌ Manual mount/remount required

Method 3: VMGate Installer (Coming Soon)

Automated Windows installer that handles everything automatically.

Status: ⏳ In Development

---

METHOD 1: TERMUX + SYSTEMIZER (DETAILED)

Step 1: Install Termux

1. Open Google Play Store on your device
2. Search for "Termux"
3. Install "Termux" by Fredrik Fornwall
4. Open Termux app
5. Grant storage permission when prompted

Note: Termux from Google Play Store works fine for this purpose.

---

Step 2: Install Systemizer Magisk Module

Option A: Via Magisk Manager (Recommended)

1. Open Magisk Manager app on your device
2. Tap the "Modules" tab (bottom navigation)
3. Tap the "Browse" button (or search icon)
4. Search for "Systemizer"
5. Find "Systemizer" by Veez21
6. Verify version is v17.3.1 before downloading
7. Tap "Download"
8. After download completes, tap "Install"
9. Wait for installation to complete
10. Reboot device when prompted

Option B: Manual Installation (If not found in Magisk Manager)

1. Download Systemizer v17.3.1 ZIP file:
   • Direct Download (recommended)
   • GitHub Release → Download Systemizer-v17.3.1.zip from the releases page (alternative)
2. Open Magisk Manager app
3. Tap "Modules" tab
4. Tap "Install from storage" (or "+" button)
5. Navigate to Downloads folder
6. Select Systemizer-v17.3.1.zip
7. Wait for installation to complete
8. Reboot device when prompted

After Reboot:

• Open Magisk Manager
• Go to "Modules" tab
• Verify "Systemizer v17.3.1" shows as installed and enabled

---

Step 3: Download and Install VMGate APK

Option A: Via File Manager (Recommended)

1. Download VMGate APK to your device (from Startel website or email)
2. Open file manager app
3. Navigate to Downloads folder
4. Tap on VMGate_V1_5_1_68A_release.apk (or current version)
5. Tap "Install"
6. Grant "Install from unknown sources" permission if prompted
7. Wait for installation to complete
8. DO NOT LAUNCH the app yet (we need to systemize it first)

Option B: Via ADB (If you have computer)

adb install -r VMGate_V1_5_1_68A_release.apk

Verification:

• Open Settings → Apps
• Search for "VMGate"
• Verify it appears in app list
• Do not open it yet

---

Step 4: Systemize VMGate Using Termux

1. Open Termux app
2. Type the following commands (press Enter after each):

   su

   Expected: Magisk/root permission prompt appears

   • Tap "Grant" or "Allow" to grant root access
   • You should see prompt change to # (root shell)

   setenforce 0

   Expected: Command completes silently (no output)

   • This temporarily disables SELinux to allow systemization

   systemize

   Expected: Systemizer text menu appears with a numbered list of installed apps

3. In Systemizer text menu:
   • You will see a numbered list of apps (e.g., 1. App1, 2. App2, 3. VMGate, etc.)
   • Find the number corresponding to "VMGate" in the list
   • Type the number (e.g., if VMGate is item 3, type 3)
   • Press Enter

   Expected: Systemizer asks for installation type:

   Select installation type:
   1. System/App
   2. System/Priv-App

   • Type 2 (for System/Priv-App)
   • Press Enter

   Expected: Systemizer asks for confirmation:

   Systemize VMGate to /system/priv-app/VMGate/? [Y/n]:

   • Type Y (capital Y)
   • Press Enter

   Expected Output:

   [INFO] Systemizing VMGate...
   [INFO] Moving to /system/priv-app/VMGate/
   [INFO] Setting permissions...
   [INFO] Systemization complete!

4. Reboot device:

   reboot

   Or manually: Hold power button → Reboot

Note: Systemizer is a text-only application. All interactions are done by typing numbers/letters and pressing Enter. There are no taps or GUI buttons.

---

Step 5: Verify Systemization

After device reboots:

Simple Verification (Recommended):

1. Open VMGate app from app drawer
2. Check the title bar at the top of the screen:
   • ✅ If title shows: VMGate → App is properly systemized
   • ❌ If title shows: VMGate - Not System App → App is NOT systemized (repeat Step 4)

This is the easiest and most reliable verification method. The app automatically detects if it's properly systemized. When NOT systemized, it displays "VMGate - Not System App" in the title bar. When properly systemized, it shows only "VMGate".

Alternative Verification Methods (If needed):

Method A: File System Check (Termux)

su
ls -la /system/priv-app/VMGate/

Expected Output:

-rw-r--r-- 1 root root 46934528 Nov 29 12:00 VMGate.apk

Method B: File Manager (Root Explorer/FX File Manager)

1. Open file manager with root access
2. Navigate to: /system/priv-app/VMGate/
3. Verify you see:
   • VMGate.apk file exists
   • File permissions: rw-r--r-- (644)
   • File owner: root:root

If verification fails:

• Systemization may not have completed
• Repeat Step 4
• Check Magisk module is enabled
• Check root access is working

---

Step 6: First Launch and Setup

1. Launch VMGate app:
   • Find VMGate icon in app drawer
   • Tap to open
2. Initial Setup:
   • License Activation: Enter your Customer ID (obtained from Startel portal) and tap "Activate"
   • Accessibility Service: VMGate should automatically enable Accessibility Service (you're systemized). If dialog appears, tap "Allow"
   • SIP Configuration: Configure your SIP server settings (IP, port, username, password)
   • SIM Configuration: Configure SIM 1 and SIM 2 settings, daily call limits, and other preferences

📖 For detailed configuration instructions, see the VMGate User Manual.

The User Manual contains complete documentation for:

• License activation and management
• SIP server configuration
• SIM settings and call limits
• All available settings and options
• Troubleshooting guides
• Advanced features

---

METHOD 2: ADB SYSTEMIZATION (ALTERNATIVE)

Prerequisites:

• Computer with ADB installed
• USB cable
• Device connected via USB
• USB Debugging enabled

Step 1: Install VMGate APK

adb install -r VMGate_V1_5_1_68A_release.apk

Step 2: Systemize via ADB

# Remount /system as read-write
adb shell su -c "mount -o remount,rw /system"

# Create VMGate directory
adb shell su -c "mkdir -p /system/priv-app/VMGate"

# Copy APK to system partition
adb push VMGate_V1_5_1_68A_release.apk /sdcard/VMGate.apk
adb shell su -c "cp /sdcard/VMGate.apk /system/priv-app/VMGate/VMGate.apk"

# Set correct permissions
adb shell su -c "chmod 644 /system/priv-app/VMGate/VMGate.apk"
adb shell su -c "chown root:root /system/priv-app/VMGate/VMGate.apk"

# Remount /system as read-only
adb shell su -c "mount -o remount,ro /system"

# Reboot device
adb reboot

Step 3: Verify Systemization

After reboot:

adb shell su -c "ls -la /system/priv-app/VMGate/"

Expected: VMGate.apk should be listed with permissions 644 and owner root:root

---

TROUBLESHOOTING

Issue: "Permission denied" in Termux

Solution:

• Ensure root access is granted
• Check Magisk Manager → Superuser → Termux is allowed
• Try su command again

---

Issue: "Read-only file system" error

Solution:

• Ensure setenforce 0 was run before systemize
• Check Magisk Systemizer module is installed and enabled
• Try remounting manually:

  su
  mount -o remount,rw /system

---

Issue: VMGate not in /system/priv-app after reboot

Possible Causes:

• Magisk mount not persisting
• Systemizer module not working correctly
• System partition not properly mounted

Solutions:

1. Check Magisk Manager → Modules → Systemizer is enabled
2. Reboot device again
3. Try systemization again
4. Check Magisk logs for errors

---

Issue: Accessibility Service still requires manual enable

Symptoms:

• "Allow restricted settings" dialog appears
• Service cannot be enabled programmatically

Possible Causes:

• VMGate not properly systemized
• App not in system/priv-app
• Permissions not set correctly

Solutions:

1. Verify systemization (Step 5)
2. Check file permissions are 644
3. Check file owner is root:root
4. Reboot device
5. If still fails, contact support

---

Issue: "Systemizer command not found"

Solution:

• Ensure Systemizer Magisk module is installed
• Reboot device after installing module
• Check module is enabled in Magisk Manager
• Try: which systemize (should show path)

---

Issue: SELinux blocking systemization

Solution:

• Always run setenforce 0 before systemize
• This temporarily disables SELinux enforcement
• SELinux will re-enable on reboot (normal behavior)

---

POST-INSTALLATION CHECKLIST

After successful installation, verify:

• [ ] VMGate APK is in /system/priv-app/VMGate/
• [ ] File permissions are 644 (rw-r--r--)
• [ ] File owner is root:root
• [ ] App launches successfully
• [ ] License activation works
• [ ] Accessibility Service enables automatically (or with one tap)
• [ ] SIP registration works
• [ ] Audio bridging works (test with a call)

---

UNINSTALLATION

To remove VMGate:

1. Revert from system partition using Systemizer:
   • Open Termux app
   • Type:

     su
     systemize

   • In Systemizer menu, type 4 (for "Revert apps")
   • Press Enter
   • Find VMGate in the list (note the number)
   • Type the number corresponding to VMGate
   • Press Enter
   • Systemizer asks for confirmation: Type Y (capital Y)
   • Press Enter
   • Wait for revert process to complete
2. Reboot device:

   reboot

   Or manually: Hold power button → Reboot

3. After reboot, uninstall VMGate:
   • Open Settings → Apps
   • Find VMGate
   • Tap "Uninstall"
   • Confirm uninstallation

Note: Uninstalling removes VMGate completely. License remains tied to device until transferred.

---

SUPPORT

If you encounter issues:

1. Check this troubleshooting section
2. Verify all prerequisites are met
3. Check Magisk and root access are working
4. Contact Startel support: noc.am@startelinternational.com

Include in support request:

• Device model and Android version
• Magisk version
• Systemizer module version
• Error messages (screenshot or copy-paste)
• Steps you've already tried

---

APPENDIX: REQUIRED SOFTWARE VERSIONS

Magisk Version

Recommended: Magisk v27.0

Download Links:

• GitHub Releases Page: https://github.com/topjohnwu/Magisk/releases/tag/v27.0 → Download app-release.apk from the releases page

Installation:

1. Download APK to device
2. Install APK (enable "Install from unknown sources" if needed)
3. Open Magisk Manager
4. Follow Magisk installation instructions for your device

---

Systemizer Module Version

Required: Systemizer v17.3.1 by Veez21

Download Links:

• Direct Download: Systemizer-v17.3.1.zip (recommended)
• GitHub Releases Page: https://github.com/Veez21/Systemizer/releases/tag/v17.3.1 → Download Systemizer-v17.3.1.zip from the releases page (alternative)

Installation:

• Via Magisk Manager (preferred): Browse modules → Search "Systemizer" → Install v17.3.1
• Manual: Download ZIP → Magisk Manager → Modules → Install from storage

---

Verifying Versions

Check Magisk Version:

• Open Magisk Manager
• Version shown at top of main screen
• Should show: "Magisk v27.0"

Check Systemizer Version:

• Open Magisk Manager → Modules tab
• Tap on "Systemizer"
• Version info shown in module details
• Should show: "v17.3.1"

---

END OF INSTALLATION GUIDE

Next Steps: After successful installation, proceed to VMGate User Manual for configuration and usage instructions.