System Admin Panel Guide

The System Admin Panel is where you manage all tenants, users, and licenses across your entire SaaS platform.

Accessing the Admin Panel

URL: http://admin.yourdomain.com/admin

Default credentials:

• Email: [email protected]
• Password: password

Security: Change the default password immediately after installation!

Dashboard

After login, you'll see the admin dashboard with a quick overview.

The sidebar provides access to:

• Dashboard - Overview and quick actions
• Tenancy → Tenants - Manage all tenants
• System → Users - Manage system users
• Licensing → Licenses - Manage license keys

Managing Tenants

Viewing Tenants

Navigate to Tenancy → Tenants to see all tenants.

The table shows:

• Name - Tenant organization name
• Slug - Subdomain identifier
• Domain - Custom domain (if configured)
• Active - Whether tenant is active
• Users - Number of users
• Trial Ends - Trial expiration date
• Plan - Current subscription plan

Creating a Tenant

1. Click New tenant
2. Fill in the form:
   • Name - Organization name (e.g., "Acme Corp")
   • Slug - Subdomain (e.g., "acme" → acme.yourdomain.com)
   • Domain - Optional custom domain
   • Is Active - Enable/disable tenant
3. Click Create

The tenant will be accessible at http://slug.yourdomain.com/app

Creating Tenant Owner

After creating a tenant, you can create the owner user:

1. Click View on the tenant
2. In the tenant detail, click Create Owner
3. Fill in owner details:
   • Name - Owner's full name
   • Email - Owner's email address
   • Password - Initial password
4. Click Create

The owner can now log in at the tenant's subdomain.

Editing a Tenant

1. Click Edit on the tenant row
2. Modify settings as needed
3. Click Save

Deleting a Tenant

1. Click Delete on the tenant row
2. Confirm the deletion

Warning: This soft-deletes the tenant. Data can be recovered from the database if needed.

Managing System Users

Viewing Users

Navigate to System → Users to see all users across all tenants.

The table shows:

• Name - User's full name
• Email - Email address
• Tenant - Which tenant they belong to
• Owner - Whether they're a tenant owner
• Verified - Email verification status

Creating a User

1. Click New user
2. Fill in the form:
   • Name - User's full name
   • Email - Email address
   • Password - Initial password
   • Tenant - Assign to a tenant
3. Click Create

Editing a User

1. Click Edit on the user row
2. Modify details as needed
3. Click Save

Managing Licenses

The licensing system helps you track and validate software licenses.

Viewing Licenses

Navigate to Licensing → Licenses to see all license keys.

Generating a License

1. Click New license
2. Fill in:
   • Customer Name - Buyer's name
   • Customer Email - Buyer's email
   • License Type - Regular or Extended
   • Purchase Code - CodeCanyon purchase code (optional)
   • Expires At - License expiration (optional)
3. Click Create

A unique license key will be generated automatically.

License Key Format

License keys follow this format:

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

Each key includes:

• Type indicator (R = Regular, E = Extended)
• Random alphanumeric characters
• HMAC checksum for validation

Validating a License

You can validate a license via CLI:

php artisan license:validate XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

User Profile

Click your avatar in the top-right corner to access:

• Sign out - Log out of the admin panel

Security Best Practices

1. Change default password immediately
2. Limit admin access - Only create admin accounts when necessary
3. Use strong passwords - Minimum 12 characters, mixed case, numbers
4. Monitor activity - Check logs regularly for suspicious activity
5. Keep updated - Apply security updates promptly

Next Steps

• Tenant Panel Guide - Learn about tenant administration
• Billing Setup - Configure subscription billing
• API Quick Start - Integrate via API