README

Bixa - Hosting Management Platform

Note:
Development is active again! A bugfix release is coming to address currently known issues. Pull requests are welcome and will still be accepted. If you want to see a feature, feel free to contribute it.

👀 What is Bixa?

Bixa is a comprehensive hosting account and support management system designed primarily for MOFH (MyOwnFreeHost). Built with Laravel 11, it provides a robust platform for managing hosting accounts, support tickets, SSL certificates, and more.

🎮 User Features

• Dashboard: Central hub with account overview and quick service access
• Hosting Management: Create and manage up to 3 hosting accounts
• SSL Certificates: Secure websites with free SSL certificates
• Support Tickets: Get technical assistance through the ticket system
• Knowledge Base: Access helpful articles and documentation
• Profile Management: Update personal information and security settings
• Two-Factor Authentication: Enhanced account security
• Notifications: Stay informed about account activities
• Web FTP: Manage website files directly through the browser
• Tools: Case converter, code beautifier, base64 encoder/decoder, and more
• WHOIS Lookup: Check domain registration information

👑 Admin Features

• Admin Dashboard: System performance monitoring and statistics
• User Management: Create, edit, and manage all user accounts
• Hosting Management: Configure MOFH API and server settings
• Ticket System: Handle support tickets and monitor staff performance
• Knowledge Base Management: Create and organize articles for users
• Notification System: Communicate with users through announcements
• System Settings: Configure platform behavior and appearance
• Advertising Management: Control on-site advertisements
• Domain Management: Manage allowed domain extensions
• Email Templates: Customize system-generated emails
• Data Migration: Import data from older platform versions

🔌 Integrations

• MOFH (MyOwnFreeHost)
• Iconcaptcha for form protection
• ACMEv2 SSL certificate provider (Let's Encrypt)
• Site.Pro website builder
• SMTP email services

🚀 Getting Started

🚅 Requirements

Your server needs to meet the following minimum requirements:

• PHP v8.1 or above
• MySQL v5.7 or above
• Laravel 11 compatible server
• A valid, trusted SSL certificate

💾 Installation

For detailed installation instructions, please refer to our comprehensive documentation at bixa.app/docs/installation.

In brief:

1. Download the latest release from our GitHub repository
2. Install PHP dependencies using Composer (see installation guide for VPS vs cPanel instructions)
3. Upload to your web hosting account and create a database
4. Configure the .env file manually with your database settings
5. Configure the .htaccess file for proper URL routing
6. Import the included bixa.sql file to your database using phpMyAdmin
7. Use the included demo account to log in, then change your credentials

No automatic installer is available - configuration must be done manually as described in our installation guide.

📧 SMTP Services

Here are some recommended SMTP services with free tiers that work well with Bixa:

• Mailtrap: 500 emails/month free (testing), 1,000 emails/month free (production)
• Mailjet: 6,000 emails/month free
• SendGrid: 1000 emails/day free

📚 Documentation

For comprehensive documentation covering all aspects of using and administering Bixa, please visit our official documentation at bixa.app/docs.

The documentation includes:

• User Guide
• Admin Guide
• API Documentation

🤔 Need Help?

• Open an issue if you've discovered a bug or have a feature request
• Join our Telegram group for community support and discussions
• English is the primary language for communication

👍 Like Bixa?

If you find Bixa useful, please consider making a donation to support its development.

©️ Copyright

Code released under the GPL-2.0 license.