Logs

The Logs tab gives you read-only access to your project's runtime logs — nginx and application — without dropping into SSH. Open it from the project's tab strip in the Console.

The Logs tab requires the Read logs permission, granted to all built-in roles (Owner, Admin, Manager, Developer, Viewer).

Available streams

Three log streams are available, switchable from a dropdown at the top of the tab:

  • nginx access — every request nginx served, with status code, response time, user agent
  • nginx error — nginx-level errors (502 / 504 / 503 responses, upstream connection failures, configuration issues)
  • Application log — for Laravel projects, this reads storage/logs/laravel.log; for Node.js projects, your console.log and console.error output

If your application writes to a non-standard log file, you'll need to point it at storage/logs/laravel.log (or the framework equivalent) for the tab to show it.

Tail mode

Click Tail to switch the viewer into live mode — new log lines stream in as your application produces them. Click again to pause; useful when you spot something interesting and want to scroll up without it being scrolled away by new lines.

When tail mode is paused, an indicator at the bottom shows you how many new lines arrived while you were reading. Click the indicator to jump back to the live tail.

Colour and formatting

ANSI escape codes from your application output (chalk-coloured Node output, Laravel's coloured log levels) are rendered as actual colours in the viewer.

Permission

The Logs tab is available to anyone with the Read logs permission. The five built-in roles (Owner / Admin / Manager / Developer / Viewer) all grant this by default — so even a read-only Viewer can use the tab to investigate without needing higher permissions. See Members for the role breakdown.

Where logs live on the server

Useful to know if you ever need to grep across log files via SSH:

  • nginx access/var/log/nginx/PROJECT_NAME_access.log
  • nginx error/var/log/nginx/PROJECT_NAME_error.log
  • Laravel application/home/depfloy/PROJECT_ID/shared/storage/logs/laravel.log (persists across deployments)

The Console reads from these files directly, so what you see in the tab matches what you'd see with tail -f.

Was this page helpful?