XFoneOS WorkStation
XFoneOS WorkStation is available to approved XTC Mobile OEMs and selected Resellers. This program enables a Power User to make LynX Phones.
It is compatible with Google Pixel 7, 9 and 9 Pro models.
XFoneOS WorkStation (XFS)
User Manual – LynX Phone Provisioning Tool
1. Overview
XFoneOS WorkStation (XFS) is a secure provisioning application used to:
- Manage XFoneOS license keys
- Install XFoneOS onto LynX Phone devices
- Track installations and device assignments
- Ensure controlled, auditable provisioning
2. System Features
- License key database
- Automated installer compatible with Google Pixel 7, 9, and 9 Pro
- Controlled provisioning of customers
- Secure flashing workflow
Core Principles:
Privacy | Security | Control
The Edge of Liberty
3. System Requirements
- Computer running:
- Linux, macOS, or Windows
- Python 3.11+
- USB connection to device
- XFoneOS installation files placed in:
- data/xfs/PX7/
- data/xfs/PX9/
- data/xfs/PX9Pro/
4. Starting XFS
Launch the application:
python app.py
5. Login Screen
You will be prompted for:
- Master Password
- Username
- Password
Important:
- The Master Password decrypts:
- The XFS database
- Installer files
- If incorrect, the system cannot open
6. Main Dashboard
After login, you will see:
6.1 License Inventory
Displays:
- Model type (PX7 / PX9 / PX9 Pro)
- Total keys
- Available keys
- Used keys
6.2 Installation History
Tracks:
- Customer name
- Device model
- Serial number
- Installation date
- Installer (you)
6.3 Installer Output
Live log showing:
- Flash process
- Errors (if any)
- Script output
7. Provisioning a LynX Phone
Step 1: Connect Device
- Connect phone via USB
- Ensure device is ready for flashing (fastboot mode if required)
Step 2: Click
“Make a LynX Phone”
Step 3: Enter Details
You will be prompted for:
- Model
- PX7
- PX9
- PX9 Pro
- Customer Name
- Model Serial Number
-
Found on device:
Settings → Model
Step 4: Start Installation
Click:
Start Installation
8. What Happens Automatically
XFS performs the following:
- Allocates the next available license key
- Records:
- Customer
- Serial number
- Installer
- Date
- Decrypts XFoneOS installation files
- Runs installer:
- Linux: flash-all.sh
- Windows: flash-all.bat
- Re-encrypts installation files
- Logs all output
9. License Security Model
Each license key is:
- Pulled from a secure pool
- Encrypted using:
- Username
- Device serial number
- Installation date
- Installer
This ensures:
- Device binding
- Non-reusability
- Traceability
10. File Structure (Important)
data/
├── xfs.db.enc (encrypted database)
└── xfs/
├── PX7/
├── PX9/
└── PX9Pro/
11. Best Practices
✅ Always:
- Verify correct model before flashing
- Confirm serial number accuracy
- Use a strong master password
- Keep system offline if possible
❌ Never:
- Share master password
- Modify encrypted files manually
- Reuse devices without re-provisioning
- Interrupt installation mid-process
12. Troubleshooting
❌ Login fails
- Check username/password
- Ensure correct master password
❌ “No available license keys”
- License pool is empty
- Contact admin to add keys
❌ Installer script not found
Check:
data/xfs/<MODEL>/
Ensure:
- flash-all.sh or .bat exists
❌ Installation fails
- Check Installer Output panel
- Verify device connection
- Confirm correct drivers / fastboot
13. Security Notes
- Database is encrypted at rest
- Working files are encrypted except during install
- License keys are never stored in plaintext after allocation
14. Support
Email:
support@xtcmobile.com
