You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
## Welcome to Liberu, our visionary open-source initiative that marries the power of Laravel 12, PHP 8.5 and Filament 5.2 to redefine the landscape of web development.
## Open-source Kubernetes, Docker & Standalone Web Hosting Control Panel — powered by Laravel 12, PHP 8.5 and Filament 5
16
+
16
17
17
-
A modular, **Kubernetes-native**Laravel control panel for managing web hosting: virtual hosts (NGINX), BIND DNS zones, Postfix/Dovecot mail, MySQL databases, and container orchestration. Designed for sysadmins and self-hosting teams who want a single web interface to manage hosting infrastructure with production-grade**Kubernetes deployment** (recommended), as well as Docker Compose and standalone options.
18
+
**Liberu Control Panel** is a modular, **Kubernetes-native**open-source web hosting control panel built on Laravel 12, PHP 8.5, Filament 5 and Livewire 4. It gives sysadmins and self-hosting teams a single, modern web interface to manage their entire hosting infrastructure — from NGINX virtual hosts and BIND DNS zones to Postfix/Dovecot mail services, MySQL databases, and full container orchestration. Whether you run a small VPS or a multi-region cloud cluster, Liberu scales with you: deploy on**Kubernetes** (recommended for production), **Docker Compose**, or a traditional **standalone** server — all from one codebase.
18
19
19
20
> **🚀 Production-Ready Kubernetes Deployment**
20
21
> Kubernetes is the **recommended deployment method** for production environments, offering auto-scaling, high availability, and enterprise-grade orchestration. See our [Complete Kubernetes Installation Guide](docs/KUBERNETES_INSTALLATION.md) and [Managed Kubernetes Setup](docs/MANAGED_KUBERNETES_SETUP.md) for AWS EKS, Azure AKS, Google GKE, and DigitalOcean DOKS.
@@ -58,7 +59,7 @@ The easiest way to install the control panel is using our **unified installation
58
59
- Rocky Linux 8/9/10
59
60
- CloudLinux 8/9/10 (Standalone only)
60
61
61
-
**One-Line Installation:**
62
+
**Option A — Command-line installer:**
62
63
63
64
```bash
64
65
# Clone the repository
@@ -69,7 +70,11 @@ cd control-panel-laravel
69
70
sudo ./install.sh
70
71
```
71
72
72
-
The script will:
73
+
**Option B — Graphical (GUI) installer:**
74
+
75
+
For a point-and-click installation experience, navigate to **Kubernetes → Helm Charts** inside the control panel after an initial deployment. The built-in [Helm GUI Installer](docs/HELM_GUI_INSTALLER.md) lets you install, upgrade, and monitor all services without touching the command line.
76
+
77
+
The script / GUI wizard will:
73
78
1. Detect your operating system
74
79
2. Present a menu to choose installation method
75
80
3. Install all required dependencies
@@ -452,16 +457,33 @@ If you maintain or use one of these projects and would like a more detailed desc
452
457
453
458
Contributing
454
459
455
-
Contributions are welcome. Please open issues for bugs or feature requests, and submit pull requests from a feature branch. Ensure CI passes and include tests for new behavior where appropriate. For larger changes, open a short proposal issue first.
460
+
Contributions are very welcome! We follow a standard GitHub flow:
461
+
462
+
1.**Fork** the repository and create a feature branch from `main`.
463
+
2.**Make your changes** — include tests for any new behaviour where appropriate.
464
+
3.**Ensure CI passes** — run `composer test` / `npm run test` locally before pushing.
465
+
4.**Open a Pull Request** against the `main` branch with a clear description of what changed and why.
466
+
5. For larger features or architectural changes, please **open an issue first** to discuss the proposal before writing code.
467
+
468
+
We review PRs as quickly as possible. All contributors are expected to follow the project's code of conduct. Bug reports and feature requests via GitHub Issues are also warmly encouraged.
456
469
457
470
License
458
471
459
-
This project is licensed under the MIT License — see the LICENSE file for details.
472
+
This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for full details.
473
+
474
+
The MIT License is one of the most permissive open-source licenses available. Key benefits:
475
+
476
+
-**Freedom to use** — use the software in any project, commercial or personal, at no cost.
477
+
-**Freedom to modify** — adapt and extend the code however you need without restriction.
478
+
-**Freedom to distribute** — share the original or modified software with anyone.
479
+
-**Minimal obligations** — simply retain the copyright notice and license text; no copyleft or viral provisions.
480
+
-**Business-friendly** — compatible with proprietary software and most other open-source licenses.
460
481
461
482
Where to get help
462
483
463
484
- Use GitHub Issues for bugs and feature requests.
464
485
- For direct support or urgent questions, contact the maintainers via the project site: https://liberu.co.uk
0 commit comments