jabali-panel/README.md

<p align="center">
  <img src="public/images/jabali_logo.svg" alt="Jabali Panel" width="140">
</p>
<h1 align="center">Jabali Panel</h1>

A modern web hosting control panel for WordPress and general PHP hosting. Built with Laravel 12, Filament v5, Livewire 4, and Tailwind CSS v4.

Version: 0.9-rc1 (release candidate)

This is a release candidate. Expect rapid iteration and breaking changes until 1.0.

## Highlights

- Multi-tenant isolation with per-user Linux accounts and PHP-FPM pools
- Agent-driven automation for domains, SSL, mail, DNS, backups, and migrations
- cPanel and WHM migrations with detailed, step-by-step logs
- Built-in mail stack (Postfix, Dovecot, Rspamd) with webmail SSO
- DNS management with templates and optional DNSSEC
- Backups for users and servers with schedules, retention, and remote targets
- Security controls including firewall, Fail2ban, and ClamAV scanning

## Screenshots

Admin panel:

- Dashboard: ![Admin Dashboard](docs/screenshots/admin-dashboard.png)
- Server Status: ![Server Status](docs/screenshots/admin-server-status.png)
- Server Settings: ![Server Settings](docs/screenshots/admin-server-settings.png)
- Security Center: ![Security Center](docs/screenshots/admin-security.png)
- Users: ![User Management](docs/screenshots/admin-users.png)
- SSL Manager: ![SSL Manager](docs/screenshots/admin-ssl-manager.png)
- DNS Zones: ![DNS Zones](docs/screenshots/admin-dns-zones.png)
- Backups: ![Admin Backups](docs/screenshots/admin-backups.png)
- Services: ![Services](docs/screenshots/admin-services.png)

User panel and flows:

- User Dashboard: ![User Dashboard](docs/screenshots/user-dashboard.png)
- Domain Management: ![User Domains](docs/screenshots/user-domains.png)
- Backups: ![User Backups](docs/screenshots/user-backups.png)
- cPanel Migration: ![cPanel Migration](docs/screenshots/user-cpanel-migration.png)

Regenerate screenshots with:

```
node tests/take-screenshots.cjs --output-dir=docs/screenshots
```

Optional overrides:

```
node tests/take-screenshots.cjs --output-dir=docs/screenshots --base-url=https://panel.example.com
```

## Feature Map

### Admin Panel

- Server dashboard with stats, health, and recent activity
- User management with suspension and quota tracking
- Service manager for systemd services
- PHP version manager and PHP-FPM pool management
- DNS zones, templates, and DNSSEC management
- SSL issuance, renewal, and certificate inventory
- IP address management (default and per-domain assignments)
- Backups and restores (local + remote, schedules + retention)
- Migrations (cPanel restore and WHM downloads)
- Security center (firewall, Fail2ban, ClamAV, security scans)
- Audit logs and email notifications

### User Panel

- Domains and redirects with automatic Nginx config
- DNS records editor
- Mail domains, mailboxes, and forwarders
- Webmail SSO (Roundcube)
- WordPress manager (install, scan, updates, SSO)
- File manager plus SFTP/SSH key management
- Databases and user permissions
- PHP settings per account
- SSL certificates and renewals
- Cron jobs
- Backups and restore
- Logs and statistics
- Protected directories

### Platform

- Root-level agent for privileged operations
- Queue-backed jobs for long-running tasks
- Self-healing service monitor and alerts
- Redis ACL isolation for WordPress caching
- Multi-language UI

## Architecture

- Control plane: Laravel app with Filament panels
- Data plane: root agent handling privileged operations
- Job queue: async tasks and migration steps
- Logging: agent and panel logs for troubleshooting

Service stack (single-node default):

- Nginx + PHP-FPM
- MariaDB (user databases)
- SQLite (panel metadata by default)
- Postfix, Dovecot, Rspamd
- BIND9 (DNS)
- Redis
- Fail2ban and ClamAV (optional)

## Requirements

- Fresh Debian 12 or 13 install (no pre-existing web or mail stack)
- A domain for panel and mail (with glue records if hosting DNS)
- PTR (reverse DNS) for mail hostname
- Open ports: 22, 80, 443, 25, 465, 587, 993, 995, 53

## Installation

Quick install:

```
curl -fsSL https://raw.githubusercontent.com/shukiv/jabali-panel/main/install.sh | sudo bash
```

Optional flags:

- `JABALI_MINIMAL=1` for core-only install
- `JABALI_FULL=1` to force all optional components

After install:

- Admin panel: `https://your-host/jabali-admin`
- User panel: `https://your-host/jabali-panel`
- Webmail: `https://your-host/webmail`

## Upgrades

```
cd /var/www/jabali
php artisan jabali:upgrade
```

Check for updates only:

```
php artisan jabali:upgrade --check
```

## CLI

```
jabali --help
jabali backup create <user>
jabali backup restore <path> --user=<user>
jabali cpanel analyze <file>
jabali cpanel restore <file> <user>
```

## Development

```
composer dev
php artisan test --compact
./vendor/bin/pint
```

## Initial Release

- 0.9-rc: initial release candidate with core hosting, mail, DNS, SSL, backups, and migrations.

## License

MIT