PHPackages                             filaforge/filament-system-packages - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. filaforge/filament-system-packages

ActiveLibrary[Utility & Helpers](/categories/utility)

filaforge/filament-system-packages
==================================

System Packages widget: list all Composer packages in a Filament table

v1.0.0(8mo ago)00MITPHPPHP >=8.1

Since Aug 19Pushed 8mo agoCompare

[ Source](https://github.com/filaforge/filament-system-packages)[ Packagist](https://packagist.org/packages/filaforge/filament-system-packages)[ Docs](https://github.com/filaforge/system-packages)[ RSS](/packages/filaforge-filament-system-packages/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (3)Versions (5)Used By (0)

Filaforge System Packages
=========================

[](#filaforge-system-packages)

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

Features
--------

[](#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
------------

[](#installation)

### 1. Install via Composer

[](#1-install-via-composer)

```
composer require filaforge/system-packages
```

### 2. Publish & Migrate

[](#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

[](#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
-----

[](#setup)

### Prerequisites

[](#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

[](#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

[](#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

[](#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
-----

[](#usage)

### Accessing System Packages

[](#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

[](#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

[](#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

[](#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
---------------

[](#troubleshooting)

### Common Issues

[](#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

[](#debug-steps)

1. Check the plugin configuration:

```
php artisan config:show system-packages
```

2. Verify routes are registered:

```
php artisan route:list | grep system-packages
```

3. Check system permissions:

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

4. Test package manager:

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

5. Clear caches:

```
php artisan optimize:clear
```

6. Check logs for errors:

```
tail -f storage/logs/laravel.log
```

### Package Manager Issues

[](#package-manager-issues)

#### APT (Ubuntu/Debian)

[](#apt-ubuntudebian)

- **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)

[](#yumdnf-centosrhel)

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

Security Considerations
-----------------------

[](#security-considerations)

### Access Control

[](#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

[](#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

[](#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
------------------------

[](#performance-optimization)

### System Requirements

[](#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

[](#optimization-tips)

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

Uninstall
---------

[](#uninstall)

### 1. Remove Plugin Registration

[](#1-remove-plugin-registration)

Remove the plugin from your panel provider:

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

### 2. Roll Back Migrations (Optional)

[](#2-roll-back-migrations-optional)

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

### 3. Remove Published Assets (Optional)

[](#3-remove-published-assets-optional)

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

### 4. Remove Package and Clear Caches

[](#4-remove-package-and-clear-caches)

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

### 5. Clean Up Environment Variables

[](#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

[](#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
-------

[](#support)

- **Documentation**: [GitHub Repository](https://github.com/filaforge/system-packages)
- **Issues**: [GitHub Issues](https://github.com/filaforge/system-packages/issues)
- **Discussions**: [GitHub Discussions](https://github.com/filaforge/system-packages/discussions)

Contributing
------------

[](#contributing)

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

License
-------

[](#license)

This plugin is open-sourced software licensed under the [MIT license](LICENSE).

---

**Made with ❤️ by the Filaforge Team**

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance62

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

262d ago

Major Versions

0.1.2 → v1.0.02025-08-19

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7ccd0e302c517e0c6bc2b4ef05008e5beb1621bf5a64b17b82cdceb19566389?d=identicon)[filaforge](/maintainers/filaforge)

---

Top Contributors

[![blhk0532](https://avatars.githubusercontent.com/u/221689993?v=4)](https://github.com/blhk0532 "blhk0532 (5 commits)")

---

Tags

laravelplatformfilament

### Embed Badge

![Health badge](/badges/filaforge-filament-system-packages/health.svg)

```
[![Health](https://phpackages.com/badges/filaforge-filament-system-packages/health.svg)](https://phpackages.com/packages/filaforge-filament-system-packages)
```

###  Alternatives

[pboivin/filament-peek

Full-screen page preview modal for Filament

253319.6k12](/packages/pboivin-filament-peek)[bezhansalleh/filament-google-analytics

Google Analytics integration for FilamentPHP

205144.8k5](/packages/bezhansalleh-filament-google-analytics)[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

124139.3k2](/packages/dotswan-filament-map-picker)[creagia/filament-code-field

A Filamentphp input field to edit or view code data.

58289.3k3](/packages/creagia-filament-code-field)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[aymanalhattami/filament-context-menu

context menu (right click menu) for filament

9838.0k](/packages/aymanalhattami-filament-context-menu)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)