flock Flock home

These are the docs of the beta, v1.1.0-beta.1. Some of it isn't in the stable release yet. Stable docs

Docs  /  Tools

Logs

Laravel logs

The Logs window in the Flock app reads each site's newest log file in storage/logs (its last 2 MB) and splits it into individual entries, with their level, environment, message and details such as stack traces. With daily logs, that's today's file. The window shows the newest 200 entries.

Click Logs in the Flock panel. On Windows, it's also in the tray icon's right-click menu, and on Linux in the Flock window's main menu. Pick a site under Sites in the sidebar, then filter by level (for example Error and above) or search to find the entry you're looking for. Auto-refresh keeps the list up to date, and Clear empties every .log file of the site.

The Logs windowThe Logs windowThe Logs windowThe Logs windowThe Logs windowThe Logs window

The Logs window is part of the app. In a terminal, read the files in storage/logs directly, for example with php artisan pail or tail -f storage/logs/laravel.log.

Flock's own logs

The logs of Flock's services are there too: the daemon, the web server, PHP and every database.

Pick a service under Services in the sidebar of the Logs window.

flock logs             # list the logs you can pick
flock logs daemon      # the last 50 lines of the daemon log
flock logs web
flock logs postgres -n 200
flock logs php8.5-fpm -f   # follow, like tail -f

PHP's logs are named after the version: php8.5-fpm on macOS and Linux, php8.5-cgi on Windows.

Checking health

The top of the Flock panel says Running when everything is fine, or Needs attention with a banner that explains what's wrong. The Services section shows a status dot for every service. If something isn't working, start here.

To restart everything, click Restart at the bottom of the panel, or Restart Daemon in Settings → General.

flock status

This shows the state of the daemon and every service, and whether .test domains resolve. If something isn't working, start here.

To restart everything:

flock restart

Spotted a mistake? Edit this page on GitHub or let us know. Docs for v1.1.0-beta.1