README

A powerful Filament plugin that provides comprehensive system package management directly in your admin panel.

Features

Package Management: View, install, update, and remove system packages
Repository Management: Manage package repositories and sources
Dependency Tracking: Track package dependencies and conflicts
Update Management: Monitor and apply system updates
Security Updates: Prioritize and apply security patches
Package Search: Search for available packages
Installation History: Track package installation and removal
System Health: Monitor system package health and status
Multi-distribution Support: Support for various Linux distributions
Automated Updates: Schedule and automate package updates

Installation

1. Install via Composer

composer require filaforge/system-packages

2. Publish & Migrate

# Publish provider groups (config, views, migrations)
php artisan vendor:publish --provider="Filaforge\\SystemPackages\\Providers\\SystemPackagesServiceProvider"

# Run migrations
php artisan migrate

3. Register Plugin

Add the plugin to your Filament panel provider:

use Filament\Panel;

public function panel(Panel $panel): Panel
{
    return $panel
        // ... other configuration
        ->plugin(\Filaforge\SystemPackages\SystemPackagesPlugin::make());
}

Setup

Prerequisites

Before using this plugin, ensure your system meets these requirements:

Linux Distribution: Compatible Linux distribution (Ubuntu, CentOS, etc.)
Package Manager: Supported package manager (apt, yum, dnf, etc.)
System Permissions: Appropriate permissions for package management
Sudo Access: Sudo access for package operations

Configuration

The plugin will automatically:

Publish configuration files to config/system-packages.php
Publish view files to resources/views/vendor/system-packages/
Publish migration files to database/migrations/
Register necessary routes and middleware

Package Manager Configuration

Configure the system packages in the published config file:

// config/system-packages.php
return [
    'enabled' => env('SYSTEM_PACKAGES_ENABLED', true),
    'package_manager' => env('SYSTEM_PACKAGES_MANAGER', 'auto'),
    'update_check_interval' => env('SYSTEM_PACKAGES_UPDATE_INTERVAL', 3600),
    'auto_update' => env('SYSTEM_PACKAGES_AUTO_UPDATE', false),
    'security_updates_only' => env('SYSTEM_PACKAGES_SECURITY_ONLY', true),
    'allowed_packages' => [
        'nginx', 'apache2', 'mysql-server', 'php', 'composer',
        'git', 'nodejs', 'npm', 'docker', 'redis-server'
    ],
    'blocked_packages' => [
        'unattended-upgrades', 'snapd', 'flatpak'
    ],
    'repositories' => [
        'main' => true,
        'universe' => true,
        'multiverse' => false,
        'restricted' => false,
    ],
];

Environment Variables

Add these to your .env file:

SYSTEM_PACKAGES_ENABLED=true
SYSTEM_PACKAGES_MANAGER=auto
SYSTEM_PACKAGES_UPDATE_INTERVAL=3600
SYSTEM_PACKAGES_AUTO_UPDATE=false
SYSTEM_PACKAGES_SECURITY_ONLY=true

Usage

Accessing System Packages

Navigate to your Filament admin panel
Look for the "System Packages" menu item
Manage system packages and updates

Package Management

View Packages: Browse installed and available packages
Install Packages: Install new packages from repositories
Update Packages: Update existing packages to latest versions
Remove Packages: Remove unwanted packages
Search Packages: Search for specific packages

Update Management

Check Updates: Check for available package updates
Security Updates: Prioritize security-related updates
Update All: Update all available packages
Update Specific: Update specific packages only
Rollback: Rollback to previous package versions

Repository Management

View Repositories: List configured package repositories
Add Repositories: Add new package repositories
Enable/Disable: Enable or disable specific repositories
Repository Health: Check repository health and status

Troubleshooting

Common Issues

Permission denied: Ensure the user has sudo access for package operations
Package manager not found: Check if supported package manager is installed
Repository errors: Verify repository configuration and connectivity
Update failures: Check system resources and package conflicts

Debug Steps

Check the plugin configuration:

php artisan config:show system-packages

Verify routes are registered:

php artisan route:list | grep system-packages

Check system permissions:

# Verify the web server user has sudo access
sudo -l
whoami

Test package manager:

# Test if package manager works
sudo apt update
# or
sudo yum update

Clear caches:

php artisan optimize:clear

Check logs for errors:

tail -f storage/logs/laravel.log

Package Manager Issues

APT (Ubuntu/Debian)

Lock file errors: Remove lock files and retry
Repository issues: Check /etc/apt/sources.list
GPG key errors: Update package signing keys

YUM/DNF (CentOS/RHEL)

Repository errors: Check /etc/yum.repos.d/
GPG key issues: Import missing GPG keys
Cache corruption: Clear yum cache

Security Considerations

Access Control

Role-based permissions: Restrict package management to authorized users only
Sudo access: Limit sudo access to package management commands only
Package restrictions: Whitelist allowed packages and block dangerous ones
Audit logging: Track all package management activities

Best Practices

Never expose package management to public users
Regularly review and update package lists
Monitor package installations and removals
Implement proper user authentication and authorization
Use HTTPS for secure repository access
Regular security audits of package management

Package Security

Source verification: Verify package sources and signatures
Update policies: Implement security-first update policies
Vulnerability scanning: Scan for known package vulnerabilities
Backup strategies: Backup system before major updates

Performance Optimization

System Requirements

CPU: Sufficient CPU for package operations
Memory: Adequate RAM for package management
Storage: Fast storage for package downloads and installation
Network: Stable network for repository access

Optimization Tips

Use local package mirrors when possible
Implement package caching strategies
Schedule updates during low-traffic periods
Monitor system resources during operations

Uninstall

1. Remove Plugin Registration

Remove the plugin from your panel provider:

// remove ->plugin(\Filaforge\SystemPackages\SystemPackagesPlugin::make())

2. Roll Back Migrations (Optional)

php artisan migrate:rollback
# or roll back specific published files if needed

3. Remove Published Assets (Optional)

rm -f config/system-packages.php
rm -rf resources/views/vendor/system-packages

4. Remove Package and Clear Caches

composer remove filaforge/system-packages
php artisan optimize:clear

5. Clean Up Environment Variables

Remove these from your .env file:

SYSTEM_PACKAGES_ENABLED=true
SYSTEM_PACKAGES_MANAGER=auto
SYSTEM_PACKAGES_UPDATE_INTERVAL=3600
SYSTEM_PACKAGES_AUTO_UPDATE=false
SYSTEM_PACKAGES_SECURITY_ONLY=true

6. Security Cleanup

After uninstalling, consider:

Reviewing sudo access and removing package management permissions
Cleaning up any custom package configurations
Reviewing installed packages for security
Updating system access controls

Support

Documentation: GitHub Repository
Issues: GitHub Issues
Discussions: GitHub Discussions

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

This plugin is open-sourced software licensed under the MIT license.

Made with ❤️ by the Filaforge Team

filaforge/filament-system-packages

包简介

关键字：

README 文档