Download the PHP package filaforge/filament-system-packages without Composer

Filaforge System Packages

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

2. Publish & Migrate

3. Register Plugin

Add the plugin to your Filament panel provider:

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:

Environment Variables

Add these to your .env file:

Usage

Accessing System Packages

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

Package Management

1. View Packages: Browse installed and available packages
2. Install Packages: Install new packages from repositories
3. Update Packages: Update existing packages to latest versions
4. Remove Packages: Remove unwanted packages
5. Search Packages: Search for specific packages

Update Management

1. Check Updates: Check for available package updates
2. Security Updates: Prioritize security-related updates
3. Update All: Update all available packages
4. Update Specific: Update specific packages only
5. Rollback: Rollback to previous package versions

Repository Management

1. View Repositories: List configured package repositories
2. Add Repositories: Add new package repositories
3. Enable/Disable: Enable or disable specific repositories
4. 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

1. Check the plugin configuration:

2. Verify routes are registered:

3. Check system permissions:

4. Test package manager:

5. Clear caches:

6. Check logs for errors:

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:

2. Roll Back Migrations (Optional)

3. Remove Published Assets (Optional)

4. Remove Package and Clear Caches

5. Clean Up Environment Variables

Remove these from your .env file:

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