{"id":15028672,"url":"https://github.com/liberu-billing/billing-laravel","last_synced_at":"2026-03-13T19:07:57.696Z","repository":{"id":244143828,"uuid":"814388592","full_name":"liberu-billing/billing-laravel","owner":"liberu-billing","description":"Web hosting (cPanel, Plesk, DirectAdmin, VirtualMin) billing system built  on the latest technologies, including Laravel 12, PHP 8.4, Filament 4.0 and Livewire 3.5. Alternative to WHMCS or Blesta or HostBill.","archived":false,"fork":false,"pushed_at":"2026-03-05T08:27:26.000Z","size":60406,"stargazers_count":54,"open_issues_count":13,"forks_count":29,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-03-05T08:50:15.606Z","etag":null,"topics":["billing","docker","filamentphp","laravel","laravel11","laravel12","php","php8","php83","php84","webhost","webhosting","website"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/liberu-billing.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"liberusoftware"}},"created_at":"2024-06-12T23:17:42.000Z","updated_at":"2026-03-05T08:27:30.000Z","dependencies_parsed_at":"2024-06-23T20:30:08.031Z","dependency_job_id":"9f23c602-71e5-43e5-b4b9-7e000a2e9d02","html_url":"https://github.com/liberu-billing/billing-laravel","commit_stats":null,"previous_names":["liberu-billing/billing-laravel"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/liberu-billing/billing-laravel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liberu-billing%2Fbilling-laravel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liberu-billing%2Fbilling-laravel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liberu-billing%2Fbilling-laravel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liberu-billing%2Fbilling-laravel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liberu-billing","download_url":"https://codeload.github.com/liberu-billing/billing-laravel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liberu-billing%2Fbilling-laravel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30472990,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T17:15:31.527Z","status":"ssl_error","status_checked_at":"2026-03-13T17:15:22.394Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["billing","docker","filamentphp","laravel","laravel11","laravel12","php","php8","php83","php84","webhost","webhosting","website"],"created_at":"2024-09-24T20:08:51.437Z","updated_at":"2026-03-13T19:07:57.689Z","avatar_url":"https://github.com/liberu-billing.png","language":"PHP","funding_links":["https://github.com/sponsors/liberusoftware"],"categories":[],"sub_categories":[],"readme":"# Liberu Billing\n\n### Open-source billing, invoicing and subscription management — built with Laravel 12, Filament 5 and Livewire 4\n\n[![Install](https://github.com/liberu-billing/billing-laravel/actions/workflows/install.yml/badge.svg)](https://github.com/liberu-billing/billing-laravel/actions/workflows/install.yml) [![Tests](https://github.com/liberu-billing/billing-laravel/actions/workflows/tests.yml/badge.svg)](https://github.com/liberu-billing/billing-laravel/actions/workflows/tests.yml) [![Docker](https://github.com/liberu-billing/billing-laravel/actions/workflows/main.yml/badge.svg)](https://github.com/liberu-billing/billing-laravel/actions/workflows/main.yml) [![Codecov](https://codecov.io/gh/liberu-billing/billing-laravel/branch/main/graph/badge.svg)](https://codecov.io/gh/liberu-billing/billing-laravel) [![GitHub release](https://img.shields.io/github/release/liberu-billing/billing-laravel.svg)](https://github.com/liberu-billing/billing-laravel/releases) [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)\n\n![](https://img.shields.io/badge/PHP-8.5-informational?style=flat\u0026logo=php\u0026color=4f5b93) ![](https://img.shields.io/badge/Laravel-12-informational?style=flat\u0026logo=laravel\u0026color=ef3b2d) ![](https://img.shields.io/badge/Filament-5-informational?style=flat\u0026color=fdae4b) ![](https://img.shields.io/badge/Livewire-4-informational?style=flat\u0026color=fb70a9) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**Liberu Billing** is a modular, production-ready billing and invoicing platform for web hosting providers, SaaS businesses and digital agencies. Built on the latest Laravel, Filament and Livewire stack, it covers the full customer lifecycle — from onboarding and subscription management through to automated invoicing, payment collection and service provisioning. Whether you are running a small agency or a large hosting operation, Liberu Billing gives you a solid, extensible foundation that is easy to customise and maintain.\n\n## ✨ Main Features\n\n| Feature | Description |\n|---|---|\n| **Secure Authentication** | Powered by Laravel Jetstream with two-factor authentication, API tokens and team management |\n| **Customer Management** | Full client portal with profile, contact management and service overview |\n| **Invoice Generation** | Automated invoice creation with customisable templates, PDF export and email delivery |\n| **Payment Collection** | Integrated payment gateway support with automatic reminders and late-fee rules |\n| **Subscription Management** | Recurring billing cycles, upgrades, downgrades and pro-rata calculations |\n| **Service Provisioning** | Integration with cPanel, Plesk and other control panels for automated account setup |\n| **Webhooks \u0026 Automation** | Real-time event notifications (19+ event types) with HMAC-SHA256 signature verification and retry logic |\n| **Knowledge Base** | Hierarchical self-service help centre with full-text search and article feedback |\n| **Canned Responses** | Quick-reply templates with variable substitution for support tickets |\n| **Bulk Operations** | Mass invoice generation, email campaigns, and data import/export |\n| **Service Automation** | Auto-suspension for overdue accounts and full service lifecycle management |\n| **Admin Panel** | Beautiful Filament 5 admin UI with real-time Livewire components |\n| **Modular Architecture** | Plugin-style module system making it easy to add integrations and extend functionality |\n| **Demo Data \u0026 Tests** | Seedable demo dataset and a comprehensive automated test suite |\n\n## 🚀 Installation\n\n### Option 1 — Automated installer (recommended)\n\nRun the interactive shell installer, which guides you through environment setup, dependencies, migrations and seeding:\n\n```bash\nbash install.sh\n```\n\nOn Linux or macOS you can also launch the **graphical installer** (if available on your system) by running the script through a file manager or a desktop shortcut that executes `bash install.sh` in a terminal.\n\n### Option 2 — Manual setup\n\n1. **Copy the environment file** and configure your database, mail and app settings:\n\n```bash\ncp .env.example .env\n# Edit .env with your database credentials and mail settings\n```\n\n2. **Install PHP dependencies**, generate the application key and run migrations:\n\n```bash\ncomposer install --no-scripts\nphp artisan key:generate\nphp artisan migrate --seed\n```\n\n3. **Install and build frontend assets** (optional for admin-only use):\n\n```bash\nnpm install\nnpm run build\n```\n\n4. **Start the development server**:\n\n```bash\nphp artisan serve --host=127.0.0.1 --port=8000\n```\n\n### Option 3 — Docker / Laravel Sail\n\nBuild and run with Docker:\n\n```bash\ndocker build -t billing-laravel .\ndocker run -p 8000:8000 billing-laravel\n```\n\nOr use Laravel Sail for a full local environment:\n\n```bash\n./vendor/bin/sail up\n```\n\n\u003e **Tip:** Review `.env.example` carefully before overwriting an existing `.env` file. The `install.sh` script handles this interactively.\n\n## 📖 Documentation\n\n- [WHMCS Features Documentation](docs/WHMCS_FEATURES.md) — Webhooks, Knowledge Base, Canned Responses, Bulk Operations\n- [Modular Architecture](docs/MODULAR_ARCHITECTURE.md) — Module system and how to write extensions\n- [Control Panel Provisioning](docs/CONTROL_PANEL_PROVISIONING.md) — cPanel/Plesk integration guide\n\n## 🔗 Related Projects\n\n| Project | Description |\n|---|---|\n| [accounting-laravel](https://github.com/liberu-accounting/accounting-laravel) | Accounting tools compatible with Liberu apps |\n| [automation-laravel](https://github.com/liberu-automation/automation-laravel) | Automation workflows and background jobs |\n| [billing-laravel](https://github.com/liberu-billing/billing-laravel) | This repository — billing and invoicing for Laravel |\n| [boilerplate](https://github.com/liberusoftware/boilerplate) | Base Laravel starter used across Liberu projects |\n| [browser-game-laravel](https://github.com/liberu-browser-game/browser-game-laravel) | Example browser game built on Laravel |\n| [cms-laravel](https://github.com/liberu-cms/cms-laravel) | Content management system |\n| [control-panel-laravel](https://github.com/liberu-control-panel/control-panel-laravel) | Hosting control panel components |\n| [crm-laravel](https://github.com/liberu-crm/crm-laravel) | CRM features and customer relationship tools |\n| [ecommerce-laravel](https://github.com/liberu-ecommerce/ecommerce-laravel) | E-commerce storefront and checkout |\n| [genealogy-laravel](https://github.com/liberu-genealogy/genealogy-laravel) | Family-tree and genealogy tools |\n| [maintenance-laravel](https://github.com/liberu-maintenance/maintenance-laravel) | Maintenance scheduling and status utilities |\n| [real-estate-laravel](https://github.com/liberu-real-estate/real-estate-laravel) | Real-estate listings and property management |\n| [social-network-laravel](https://github.com/liberu-social-network/social-network-laravel) | Social network features and activity feeds |\n\n## 🤝 Contributing\n\nContributions are very welcome! Here is how to get involved:\n\n1. **Fork** the repository and create your branch from `main`.\n2. **Make your changes** — please include tests for new functionality and ensure existing tests still pass (`./vendor/bin/phpunit`).\n3. **Follow the coding style** — run `./vendor/bin/pint` to auto-format PHP code before committing.\n4. **Open a Pull Request** with a clear title and description explaining *what* changed and *why*.\n5. A maintainer will review your PR and may request changes or ask questions before merging.\n\nPlease open an issue first for larger changes so we can discuss the approach before you invest time writing code.\n\n📱 **WhatsApp**: [+44 1793 200950](https://wa.me/441793200950) — feel free to reach out with questions or ideas.\n\n## 📄 License\n\nThis project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for the full text.\n\n**What the MIT license means for you:**\n\n- ✅ **Free to use** — use Liberu Billing in personal, commercial or enterprise projects at no cost.\n- ✅ **Free to modify** — adapt the source code to suit your exact requirements.\n- ✅ **Free to distribute** — share or resell your modified version, provided the original copyright notice is retained.\n- ✅ **No warranty** — the software is provided \"as is\"; the authors are not liable for any issues arising from its use.\n\nThe MIT license is one of the most permissive open-source licenses available. It maximises freedom for users and contributors while protecting authors from liability, making it ideal for projects that want broad adoption and a healthy contributor ecosystem.\n\n## 👥 Contributors\n\n\u003ca href=\"https://github.com/liberu-billing/billing-laravel/graphs/contributors\"\u003e\u003cimg src=\"https://contrib.rocks/image?repo=liberu-billing/billing-laravel\" alt=\"Contributors\"/\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliberu-billing%2Fbilling-laravel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliberu-billing%2Fbilling-laravel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliberu-billing%2Fbilling-laravel/lists"}