FAQ

How can I access my application logs?

To display the application log file (/var/log/app.log file), run the following command:

upsun log app --tail

All the log messages generated by your app are sent to this /var/log/app.log file. This includes language errors such as PHP errors, warnings, notices, as well as uncaught exceptions.

The file also contains your application logs if you log on stderr. This log doesn’t include the default laravel.log located in /storage.

With Laravel, you can change your logging configuration to use memory and stream php://stderr. In your config/logging.php file, add or update the following configuration:

'memory' => [
    'driver' => 'monolog',
    'handler' => Monolog\Handler\StreamHandler::class,
    'with' => [
        'stream' => 'php://stderr',
    ],
    'processors' => [
        // Simple syntax...
        Monolog\Processor\MemoryUsageProcessor::class,

        // With options...
        [
           'processor' => Monolog\Processor\PsrLogMessageProcessor::class,
           'with' => ['removeUsedContextFields' => true],
       ],
    ],
],

What’s this “Oops! An Error Occurred” message about?

The Oops! An Error Occurred message comes from your app and is automatically generated based on the Laravel error template.

The server returned a “500 Internal Server Error”

If your app’s working as expected locally but you see the previous error message on Upsun, it usually means you have a configuration error or a missing dependency.

To fix this issue, search your application logs. They likely contain an error message describing the root cause:

upsun env:log app
  Reading log file azertyuiop-test-error-azerty--app@ssh.eu-5.platform.sh:/var/log/app.log
  [12-Jan-2026 11:22:08] NOTICE: fpm is running, pid 146
  [12-Jan-2026 11:22:08] NOTICE: ready to handle connections
  [12-Jan-2026 11:27:31] PHP Fatal error:  Uncaught Exception: [...]
  Stack trace: [...]

If the error occurs on a preview environment, or on the main environment of a non-production project, you can also enable Laravel’s dev/debug mode to inspect the cause of the error via the APP_DEBUG environment variable in your .environment file or via upsun console:

# Enable debug mode
export APP_DEBUG=1
# Disable debug mode
export APP_DEBUG=0

Other issues

For other issues unrelated to Laravel, see Troubleshoot development.