NixoSMS - Laravel Backend & Android Project Installation Documentation
Complete guide to setup and configure your
Laravel Self-Hosted SMS Gateway | Send Bulk SMS via Android Phone SIM
Introduction
NixoSMS is a Laravel-based self-hosted SMS gateway that lets you send bulk SMS via your Android phone’s SIM card. Manage contacts, SMS campaigns, and real-time delivery logs in one powerful dashboard — with no third-party APIs required.
Key Features
- SIM-Based SMS Sending – Use your Android phone’s SIM to send SMS via web panel
- 100% Private Infrastructure – Fully self-hosted, no third-party servers or APIs
- Laravel Powered – Built with Laravel 10 and includes a REST API for integration
- Device & SMS Management – Manage connected Android devices and message status from the admin panel
- Background Service – Android app runs reliably in the background without heavy battery use
Technical Specifications
- Backend Requirements: Laravel 10+, PHP 8.0+, MySQL 5.7+/8.0+
- Android Requirements: Android 8.0 (Oreo) or higher
- Communication Method: Encrypted REST API over HTTPS between web panel and Android app
- Included Files: Laravel Web Panel (Full Source Code), Android Studio Project (Full Source Code), SQL File,Easy Installation Documentation & Free WordPress Plugin
⚠️ Important Notice on Android Permissions & Play Store Policy
📌 This Android app is not eligible for publication on the Google Play Store.
The NixoSMS Android companion app uses several restricted and sensitive permissions required to perform SMS operations via your device’s SIM card, including:
SEND_SMS
– To send messages via SIMRECEIVE_SMS
andREAD_SMS
– For optional SMS loggingREAD_PHONE_STATE
andREAD_PHONE_NUMBERS
– For SIM and dual-SIM detectionCALL_PHONE
– For optional call functionality
These permissions are strictly regulated by Google Play, and apps using them are only permitted if they are the default SMS or Phone app, or meet very specific exceptions — which NixoSMS is not intended for.
🔒 Intended Use: Self-Hosted & Personal Deployment Only
NixoSMS is built as a self-hosted SMS gateway solution — designed for personal use, private server deployments, or in-house tools where the Android app acts as a secure bridge between your device and the Laravel backend.
It is not designed for public distribution via the Play Store or other commercial marketplaces that enforce SMS permission restrictions.
✅ Safe Distribution & Usage
You are free to:
- Install and use the Android app on your own device
- Share the APK directly with your clients or team
- Host the Laravel backend on your private server
- Sell the system via Codecanyon as source code for developers
Permissions & Privacy Policy
This section explains all the Android permissions required by the NixoSMS app, their purpose, and how user data is securely handled.
Step 1: Required Permissions Overview
NixoSMS uses the following permissions to operate as a secure and self-hosted SMS gateway:
- INTERNET – Sync with Laravel admin panel and APIs
- ACCESS_WIFI_STATE – Detect WiFi status for connectivity check
- CAMERA – Scan QR codes during device connection
- VIBRATE – Provide vibration feedback during actions
- SEND_SMS – Send SMS messages via device SIM
- READ_PHONE_STATE – Detect SIM/network status and phone info
- READ_PHONE_NUMBERS – Access device’s phone number (if available)
- READ_SMS – Access received SMS content for logging or reply (optional)
- CALL_PHONE – Enable direct calling (optional)
- FOREGROUND_SERVICE – Run background SMS sync safely
- FOREGROUND_SERVICE_DATA_SYNC – Required for background data sync on Android 10+
Step 2: When Permissions Are Used
Below are scenarios where specific permissions are triggered during app usage:
- Device QR Scanning: CAMERA
- Sending SMS: SEND_SMS, INTERNET, READ_PHONE_STATE
- Logging Received SMS: READ_SMS (optional), RECEIVE_SMS
- Device Info Display: READ_PHONE_NUMBERS, READ_PHONE_STATE
- Running Sync: FOREGROUND_SERVICE, INTERNET
- Placing Call (if enabled): CALL_PHONE
Step 3: Privacy Policy
NixoSMS is designed with privacy and transparency in mind:
- No data is sent to third-party servers
- All communication happens between the Android app and your self-hosted Laravel panel
- Messages are never sent without user or admin initiation
- No background SMS abuse or hidden activity is performed
Step 4: Security Compliance
The app follows Android’s best practices and respects user data and permissions:
- Only asks for permissions required to perform visible, expected actions
- Permissions are explained in documentation and shown during app use
- Users can revoke permissions anytime through device settings
Support
For any technical issues or questions regarding NixoSMS, please contact our support team: