Repository navigation
php artisan register:app fails: "There are no commands defined in the "register" namespace" #1606
Description
Registering a private app as described in the Heimdall-Apps wiki no longer works. The command exists in app/Console/Commands/RegisterApp.php, but artisan does not know it.
Steps to reproduce
- Put a private app folder, e.g.
MyApp, intoSupportedApps. - Run:
docker exec -it heimdall php /app/www/artisan register:app MyApp
Expected behaviour
Application Added - MyApp - <appid>
Actual behaviour
ERROR There are no commands defined in the "register" namespace.
php artisan list does not show register:app either.
Cause
Since the move to the new Laravel application structure, bootstrap/app.php only passes the console routes file to withRouting():
->withRouting(
...
commands: __DIR__.'/../routes/console.php',
...
)withRouting() then calls withCommands([routes/console.php]). Because that array is not empty, ApplicationBuilder::withCommands() does not add its default path app/Console/Commands. As a result, RegisterApp is never discovered.
Suggested fix
Register the commands directory explicitly in bootstrap/app.php, for example:
->withCommands([
__DIR__.'/../app/Console/Commands',
])Workaround
Until this is fixed, the command can be registered and run manually:
docker exec -i heimdall sh -c 'cat > /tmp/register.php' <<'PHP'
<?php
require '/app/www/vendor/autoload.php';
$app = require '/app/www/bootstrap/app.php';
$kernel = $app->make(Illuminate\Contracts\Console\Kernel::class);
$kernel->bootstrap();
$kernel->registerCommand($app->make(App\Console\Commands\RegisterApp::class));
$kernel->call('register:app', ['folder' => 'MyApp']);
echo $kernel->output();
PHP
docker exec -it -u abc heimdall php /tmp/register.php
Environment
- Heimdall version: 2.8.3
- Installation: linuxserver/heimdall Docker image on Unraid
Activity
[-]php artisan register:app fails: "There are no commands defined in the \"register\" namespace"[/-][+]php artisan register:app fails: "There are no commands defined in the "register" namespace"[/+]KodeStar commentedon Oct 3, 2026
Thanks for the detailed report. Reproduced in the 2.8.3 image, fix is in #1607.
The cause turned out to be slightly different from the
withRouting()one:Application::configure()already addsapp/Console/Commands, but only once providers have finished booting. On startup Heimdall checks forpublic/storage/.gitignoreand runsstorage:linkif it is missing. The Docker image does not ship that file, sostorage:linkran on every start, and calling Artisan during provider boot locks in the command list beforeapp/Console/Commandsis added. So explicitly adding the path inbootstrap/app.phpwould not have helped either.Until the fix is released, a simpler workaround than the script is to create that file once in the container:
(It lives inside the container, so it needs redoing if the container is recreated.)