rizkikotet/phpnuxbill repository overview

⁠PhpNuxbill-Docker

Docker-ready implementation of PHPNuxBill - PHP Mikrotik Billing System for managing vouchers and hotspot billing.

⁠Features

• All original PHPNuxBill features:

  • Voucher Generator and Print
  • Hotspot & PPPOE Support
  • Multi Router Mikrotik
  • Multi Language
  • Payment Gateway Integration
  • SMS Validation for Login
  • WhatsApp Notification for Customers
  • Telegram Notification for Admin
  • User Balance & Auto Renewal
  • Self Registration
  • FreeRadius Support

• Docker-specific enhancements:

  • PHP 8.3 with Apache
  • MySQL 8.0 database
  • Pre-configured environment
  • Persistent database storage
  • Easy deployment with docker-compose
  • Multi-arch support
  • Automatic container restart

⁠Quick Start

1. Clone this repository:

git clone https://github.com/rizkikotet-dev/PhpNuxbill-Docker.git
cd PhpNuxbill-Docker

1. Start the containers:

docker-compose up -d

1. Access the installation wizard:

• Open http://localhost⁠ in your browser
• Follow the installation steps
• Default database credentials:
  • Database Host: mysql
  • Database Name: phpnuxbill
  • Database User: phpnuxbill
  • Database Password: phpnuxbill

⁠Environment Configuration

The docker-compose.yml file includes these default settings:

• Web Interface: Port 80
• MySQL: Port 3306
• Timezone: Can be modified via TZ environment variable
• Persistent MySQL data through docker volumes

⁠System Requirements

• Docker Engine
• Docker Compose
• 1GB RAM minimum
• 10GB disk space recommended

⁠Production Deployment Notes

1. Change default database credentials in docker-compose.yml
2. Use proper SSL/TLS termination for production
3. Consider using docker secrets for sensitive data
4. Backup the mysql_data volume regularly

⁠Credits

This is a Docker implementation of PHPNuxBill⁠ by hotspotbilling.

⁠License

GNU General Public License v2.0