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(10mo ago)311MITBladePHP ^8.1

Since Aug 24Pushed 10mo 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 today

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

32

—

LowBetter than 69% of packages

Maintenance54

Moderate activity, may be stable

Popularity8

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

314d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/39787459?v=4)[Tanbhir Hossain](/maintainers/tanbhirhossain)[@tanbhirhossain](https://github.com/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

[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.2k95.4M307](/packages/laravel-horizon)[illuminate/console

The Illuminate Console package.

13046.0M6.5k](/packages/illuminate-console)[spatie/laravel-health

Monitor the health of a Laravel application

87512.0M167](/packages/spatie-laravel-health)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45444.2k1](/packages/pressbooks-pressbooks)[mwguerra/web-terminal

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

296.1k](/packages/mwguerra-web-terminal)

PHPackages © 2026

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