PHPackages                             filaforge/filament-system-tools - 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-tools

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

filaforge/filament-system-tools
===============================

System tools plugin

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

Since Aug 19Pushed 9mo agoCompare

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

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

Filaforge System Tools
======================

[](#filaforge-system-tools)

A powerful Filament plugin that provides essential system administration tools directly in your admin panel.

Features
--------

[](#features)

- **System Information**: Comprehensive system details and specifications
- **Process Management**: View, monitor, and manage system processes
- **Service Control**: Start, stop, and manage system services
- **File Management**: Browse and manage system files and directories
- **Network Tools**: Network configuration and monitoring tools
- **Log Viewer**: View and analyze system logs
- **Performance Monitoring**: Real-time system performance metrics
- **User Management**: System user and group management
- **Backup Tools**: System backup and restore utilities
- **Maintenance Tasks**: System maintenance and optimization tools

Installation
------------

[](#installation)

### 1. Install via Composer

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

```
composer require filaforge/system-tools
```

### 2. Publish & Migrate

[](#2-publish--migrate)

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

# 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\SystemTools\SystemToolsPlugin::make());
}
```

Setup
-----

[](#setup)

### Prerequisites

[](#prerequisites)

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

- **Linux/Unix System**: Compatible operating system
- **System Permissions**: Appropriate permissions for system operations
- **Sudo Access**: Sudo access for administrative operations
- **Required Tools**: Essential system utilities installed

### Configuration

[](#configuration)

The plugin will automatically:

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

### Tools Configuration

[](#tools-configuration)

Configure the system tools in the published config file:

```
// config/system-tools.php
return [
    'enabled' => env('SYSTEM_TOOLS_ENABLED', true),
    'allowed_tools' => [
        'system_info' => true,
        'process_management' => true,
        'service_control' => true,
        'file_management' => true,
        'network_tools' => true,
        'log_viewer' => true,
        'performance_monitoring' => true,
        'user_management' => true,
        'backup_tools' => true,
        'maintenance_tasks' => true,
    ],
    'restricted_directories' => [
        '/etc', '/var/log', '/home', '/root'
    ],
    'allowed_commands' => [
        'ps', 'top', 'htop', 'systemctl', 'service',
        'ls', 'cat', 'tail', 'head', 'grep'
    ],
    'log_retention_days' => env('SYSTEM_TOOLS_LOG_RETENTION', 30),
    'max_processes' => env('SYSTEM_TOOLS_MAX_PROCESSES', 100),
];
```

### Environment Variables

[](#environment-variables)

Add these to your `.env` file:

```
SYSTEM_TOOLS_ENABLED=true
SYSTEM_TOOLS_LOG_RETENTION=30
SYSTEM_TOOLS_MAX_PROCESSES=100
```

Usage
-----

[](#usage)

### Accessing System Tools

[](#accessing-system-tools)

1. Navigate to your Filament admin panel
2. Look for the "System Tools" menu item
3. Choose the tool you want to use

### Available Tools

[](#available-tools)

#### System Information

[](#system-information)

- **System Overview**: OS details, kernel version, architecture
- **Hardware Info**: CPU, memory, disk, network specifications
- **System Status**: Uptime, load average, resource usage

#### Process Management

[](#process-management)

- **Process List**: View all running processes
- **Process Details**: Detailed process information
- **Process Control**: Start, stop, and manage processes
- **Resource Monitoring**: Monitor process resource usage

#### Service Control

[](#service-control)

- **Service Status**: Check service status and health
- **Service Control**: Start, stop, restart services
- **Service Configuration**: View and edit service configurations
- **Service Logs**: View service-specific logs

#### File Management

[](#file-management)

- **File Browser**: Navigate system directories
- **File Operations**: View, edit, copy, move, delete files
- **File Permissions**: Manage file and directory permissions
- **File Search**: Search for files and content

#### Network Tools

[](#network-tools)

- **Network Status**: View network interfaces and status
- **Network Configuration**: Configure network settings
- **Connection Monitoring**: Monitor network connections
- **Network Diagnostics**: Network troubleshooting tools

#### Log Viewer

[](#log-viewer)

- **System Logs**: View system and application logs
- **Log Filtering**: Filter logs by date, level, and source
- **Log Search**: Search for specific log entries
- **Log Analysis**: Analyze log patterns and trends

#### Performance Monitoring

[](#performance-monitoring)

- **Real-time Metrics**: Live system performance data
- **Resource Usage**: CPU, memory, disk, network usage
- **Performance Trends**: Historical performance data
- **Alert System**: Performance threshold alerts

#### User Management

[](#user-management)

- **User List**: View system users and groups
- **User Operations**: Create, modify, delete users
- **Permission Management**: Manage user permissions
- **User Activity**: Monitor user activity and sessions

#### Backup Tools

[](#backup-tools)

- **System Backup**: Create system backups
- **Backup Management**: Manage backup schedules and retention
- **Restore Operations**: Restore from backups
- **Backup Verification**: Verify backup integrity

#### Maintenance Tasks

[](#maintenance-tasks)

- **System Updates**: Check and apply system updates
- **Package Management**: Manage system packages
- **Cleanup Tasks**: System cleanup and optimization
- **Health Checks**: System health diagnostics

Troubleshooting
---------------

[](#troubleshooting)

### Common Issues

[](#common-issues)

- **Permission denied**: Ensure the user has appropriate system access
- **Tool not available**: Check if the tool is enabled in configuration
- **Command failures**: Verify system utilities are installed
- **Performance impact**: Monitor tool resource usage

### Debug Steps

[](#debug-steps)

1. Check the plugin configuration:

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

2. Verify routes are registered:

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

3. Check system permissions:

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

4. Test basic system tools:

```
# Test if basic commands work
ps aux | head -10
systemctl status
```

5. Clear caches:

```
php artisan optimize:clear
```

6. Check logs for errors:

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

### Tool-Specific Issues

[](#tool-specific-issues)

#### Process Management

[](#process-management-1)

- **High process count**: Adjust max\_processes setting
- **Permission errors**: Check user permissions for process operations
- **Performance issues**: Optimize process listing and filtering

#### File Management

[](#file-management-1)

- **Access denied**: Check directory permissions and restrictions
- **Large directories**: Implement pagination for large directory listings
- **File operations**: Verify file operation permissions

#### Service Control

[](#service-control-1)

- **Service not found**: Check if service exists and is accessible
- **Permission denied**: Verify sudo access for service operations
- **Service failures**: Check service logs and dependencies

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

[](#security-considerations)

### Access Control

[](#access-control)

- **Role-based permissions**: Restrict tool access to authorized users only
- **Tool restrictions**: Limit available tools based on user roles
- **Directory restrictions**: Restrict access to sensitive directories
- **Command restrictions**: Whitelist allowed system commands

### Best Practices

[](#best-practices)

- Never expose system tools to public users
- Regularly review and update access permissions
- Monitor tool usage and log suspicious activities
- Implement proper user authentication and authorization
- Use HTTPS for secure access
- Regular security audits of tool access

### System Security

[](#system-security)

- **File permissions**: Ensure proper file and directory permissions
- **User isolation**: Limit user access to necessary tools only
- **Audit logging**: Track all system tool activities
- **Backup security**: Secure backup files and access

Performance Optimization
------------------------

[](#performance-optimization)

### System Requirements

[](#system-requirements)

- **CPU**: Sufficient CPU for tool operations
- **Memory**: Adequate RAM for tool execution
- **Storage**: Fast storage for file operations
- **Network**: Stable network for network tools

### Optimization Tips

[](#optimization-tips)

- Implement caching for frequently accessed data
- Use pagination for large data sets
- Optimize database queries and operations
- Monitor tool performance and resource usage

Uninstall
---------

[](#uninstall)

### 1. Remove Plugin Registration

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

Remove the plugin from your panel provider:

```
// remove ->plugin(\Filaforge\SystemTools\SystemToolsPlugin::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-tools.php
rm -rf resources/views/vendor/system-tools
```

### 4. Remove Package and Clear Caches

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

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

### 5. Clean Up Environment Variables

[](#5-clean-up-environment-variables)

Remove these from your `.env` file:

```
SYSTEM_TOOLS_ENABLED=true
SYSTEM_TOOLS_LOG_RETENTION=30
SYSTEM_TOOLS_MAX_PROCESSES=100
```

### 6. Security Cleanup

[](#6-security-cleanup)

After uninstalling, consider:

- Reviewing system access permissions
- Cleaning up any custom tool configurations
- Removing any scheduled tasks or cron jobs
- Updating system security settings

Support
-------

[](#support)

- **Documentation**: [GitHub Repository](https://github.com/filaforge/system-tools)
- **Issues**: [GitHub Issues](https://github.com/filaforge/system-tools/issues)
- **Discussions**: [GitHub Discussions](https://github.com/filaforge/system-tools/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

30

—

LowBetter than 64% of packages

Maintenance58

Moderate activity, may be stable

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

272d 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-tools/health.svg)

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

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