Uncaught RuntimeException: A facade root has not been set.

[KarelWintersky]

Lychee version

7.3.2

Did you check the latest Lychee version?

Yes, I did

Which PHP version are you using?

PHP 8.4

Detailed description of the problem

cat /var/log/lychee.error.log

2026/02/04 01:04:30 [error] 46568#46568: *3 FastCGI sent in stderr: "PHP message: PHP Fatal error:  Uncaught RuntimeException: A facade root has not been set. in /var/www/gallery.blacktower.wintersky.ru/vendor/laravel/framework/src/Illuminate/Support/Facades/Facade.php:360

Stack trace:
#0 /var/www/gallery.blacktower.wintersky.ru/app/Exceptions/Handler.php(435): Illuminate\Support\Facades\Facade::__callStatic()

#1 /var/www/gallery.blacktower.wintersky.ru/vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php(562): App\Exceptions\Handler->report()

#2 /var/www/gallery.blacktower.wintersky.ru/vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php(146): Illuminate\Foundation\Http\Kernel->reportException()

#3 /var/www/gallery.blacktower.wintersky.ru/public/index.php(73): Illuminate\Foundation\Http\Kernel->handle()

#4 {main}
  thrown in /var/www/gallery.blacktower.wintersky.ru/vendor/laravel/framework/src/Illuminate/Support/Facades/Facade.php on line 360" while reading response header from upstream, client: 192.168.111.2, server: _, request: "GET / HTTP/1.0", upstream: "fastcgi://unix:/run/php/php8.4-fpm.sock:", host: "gallery.blacktower.wintersky.ru"

Steps to reproduce the issue

Download latest version
unzip
set nginx virtual host
start services
run
recieve 500 fatal error

Diagnostics [REQUIRED]

No response

Browser & System [REQUIRED]

No response

Please confirm (incomplete submissions will not be addressed)

• I have provided easy and step-by-step instructions to reproduce the bug.
• I understand my bug report will be removed if I haven't met the criteria above.
• I understand that if I am requested to provide more information, I must do so within 14 days or the bug report will be closed.

[KarelWintersky]

Also

ConfigurationKeyMissingException
watermark_enabled does not exist in config!

adding WATERMARK_ENABLED = 1
to .env have no effect

[ildyria]

adding WATERMARK_ENABLED = 1
to .env have no effect

Sorry currently on vacations at the moment. So the missing configs means that it cannot find the key in the configs table, which would indicate to me that the last few migrations did no run. If you run php artisan migrate that should do the trick.

I will try to see if I can track down that issue as the front-end should not crash but display an info that migrations needs to be run.

[KarelWintersky]

But the database is completely empty...

Despairing of transferring the nearly empty gallery to the new instance (due to a facade error), I decided I could sacrifice two photos and simply install the project from scratch.

root@gallery:~# mysql lychee
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 32
Server version: 10.11.14-MariaDB-0+deb12u2 Debian 12

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MariaDB [lychee]> show tables;
Empty set (0.000 sec)

MariaDB [lychee]> 

I deleted the database and recreated it. I added the data to the env file and...

Aha, I don't see any mention in the readme of what to do if we're installing the project from scratch. Apparently, the installation script is expected to run automatically when navigating to the root of the site.

Or is it?

[ildyria]

Sorry was on vacations last week. Thank you for diving into this, I will have a look in that direction.

[ildyria]

#4092

There you go, fix comming up.