PHPackages                             tanbhirhossain/laravel-live-terminal - 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. [CLI &amp; Console](/categories/cli)
4. /
5. tanbhirhossain/laravel-live-terminal

ActiveLaravel-package[CLI &amp; Console](/categories/cli)

tanbhirhossain/laravel-live-terminal
====================================

A simple and secure web-based terminal to run Laravel Artisan commands.

v1.1.1(8mo ago)311MITBladePHP ^8.1

Since Aug 24Pushed 8mo agoCompare

[ Source](https://github.com/tanbhirhossain/laravel-live-terminal)[ Packagist](https://packagist.org/packages/tanbhirhossain/laravel-live-terminal)[ RSS](/packages/tanbhirhossain-laravel-live-terminal/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (7)Used By (0)

Laravel Live Terminal
=====================

[](#laravel-live-terminal)

[![Latest Version on Packagist](https://camo.githubusercontent.com/d1ac64f8aba39126454d73413748bfc85589d929a72f215ba727584b8f8e3a94/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f74616e62686972686f737361696e2f6c61726176656c2d6c6976652d7465726d696e616c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tanbhirhossain/laravel-live-terminal)[![Total Downloads](https://camo.githubusercontent.com/11e4f5c167eb30ebf5dd070e3ef1ab3741f7d0b031e3b7beef6184da78667a29/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f74616e62686972686f737361696e2f6c61726176656c2d6c6976652d7465726d696e616c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tanbhirhossain/laravel-live-terminal)[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)

A beautiful and secure web-based terminal to run whitelisted Laravel Artisan commands directly from your browser.

---

⚠️ Critical Security Warning
----------------------------

[](#️-critical-security-warning)

This package allows you to execute shell commands on your server from a web interface. If not properly secured, it can expose your entire application and server to catastrophic vulnerabilities.

- **NEVER** deploy this to a production environment with weak or no authentication.
- **ALWAYS** protect the terminal route with middleware that strictly limits access to trusted administrators.
- **BE CAREFUL** with the commands you add to the `allowed_commands` whitelist. Do not allow commands that can write arbitrary files or execute arbitrary code.

**You are responsible for securing this tool within your application.**

---

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

[](#installation)

You can install the package via Composer:

```
composer require tanbhirhossain/laravel-live-terminal
Next, you must publish the configuration file. This is a required step to manage your command whitelist and security settings.
code
Bash
php artisan vendor:publish --provider="Tanbhirhossain\LaravelLiveTerminal\TerminalServiceProvider" --tag="terminal-config"
This will create a config/terminal.php file in your project.
Usage
Make sure you have a working authentication system (e.g., Laravel Breeze, Jetstream).
By default, the terminal is available at http://your-app.test/live-terminal.
You must be logged in to access this route, as defined by the default auth middleware in the config.
Once you access the URL, you will see the terminal interface and can begin running commands that you have whitelisted in the configuration file.
Configuration
Customization is done in the config/terminal.php file. Let's break down each option.
PHP Executable Path
The package needs to know where your server's PHP executable is located. It tries to find it automatically, but on some server configurations (especially on Windows with WAMP/XAMPP), this can fail.
If your commands are not working, you can set the path manually.
code
PHP
// config/terminal.php

'php_path' => null,

// Example for Windows:
// 'php_path' => 'C:\php\php.exe',

// Example for Linux (usually found automatically):
// 'php_path' => '/usr/bin/php',
Allowed Commands (Whitelist)
This is your primary security control. It is an array of base commands that are allowed to run. The terminal will reject any command not on this list.
code
PHP
// config/terminal.php

'allowed_commands' => [
    'list',
    'help',
    '--version',
    'route:list',
    'view:clear',
    'config:clear',
    'cache:clear',
    'migrate',
    'migrate:status',
    'schedule:list',

    // Add your own safe commands here. For example:
    'queue:failed',
    'db:seed',
],
Note: The check is performed on the base command. This means if route:list is allowed, a user can also run route:list --json --path=api. Be mindful of the commands and options you enable.
Route Middleware
This is your primary security gate. It's an array of middleware that will be applied to the terminal's routes.
It is strongly recommended to add your own middleware to restrict access to only administrators.
code
PHP
// config/terminal.php

'middleware' => ['web', 'auth'],

// Recommended example for a project with an 'isAdmin' middleware:
// 'middleware' => ['web', 'auth', 'isAdmin'],

// Example for a project using roles/permissions (e.g., Spatie's package):
// 'middleware' => ['web', 'auth', 'role:super-admin'],
Route Path
This setting controls the URL where the terminal is accessible.
code
PHP
// config/terminal.php

'path' => 'live-terminal',

// You can change this to anything you want, for example:
// 'path' => 'super-secret-admin-console',
After changing the path, remember to clear your route cache: php artisan route:clear.
Troubleshooting
404 Not Found: Your route cache is likely out of date. Run php artisan route:clear.
White Screen or JavaScript Errors: Your application cache is likely out of date, preventing the service provider from loading. Run php artisan optimize:clear.
Commands return Apache/Nginx help menu: The package cannot find your PHP executable. Set the correct path in config/terminal.php under the php_path key.
```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance59

Moderate activity, may be stable

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

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

6

Last Release

261d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5c97480bab50dd08a6cca1cc74b3b68aa2827e608fffc696112d151c14c60688?d=identicon)[tanbhirhossain](/maintainers/tanbhirhossain)

---

Top Contributors

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

---

Tags

terminallaravelartisanweb-terminal

### Embed Badge

![Health badge](/badges/tanbhirhossain-laravel-live-terminal/health.svg)

```
[![Health](https://phpackages.com/badges/tanbhirhossain-laravel-live-terminal/health.svg)](https://phpackages.com/packages/tanbhirhossain-laravel-live-terminal)
```

###  Alternatives

[recca0120/terminal

run laravel artisan command in web application

878410.9k2](/packages/recca0120-terminal)[nunomaduro/laravel-console-menu

Laravel Console Menu is an output method for your Laravel/Laravel Zero commands.

815412.0k48](/packages/nunomaduro-laravel-console-menu)[nunomaduro/laravel-console-dusk

Laravel Console Dusk allows the usage of Laravel Dusk in Laravel/Laravel Zero artisan commands.

16255.4k7](/packages/nunomaduro-laravel-console-dusk)[mwguerra/web-terminal

A web-based terminal component for Filament/Laravel with command whitelisting and multiple connection types

251.1k](/packages/mwguerra-web-terminal)[socialengine/sniffer-rules

A Lumen 5 and Laravel 5 SquizLabs Code Sniffer 2.0 artisan command. Detect violations of a defined coding standard. It helps your code remains clean and consistent.

1248.2k1](/packages/socialengine-sniffer-rules)[sunaoka/laravel-facade-generator

Provide command line generation of facade layer files.

171.9k](/packages/sunaoka-laravel-facade-generator)

PHPackages © 2026

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