Development server

Run lazysite locally without Apache using the built-in dev server.

Development server

The built-in dev server runs lazysite locally for development and testing. It invokes the processor for each request and serves static assets directly. Not for production use.

Invocation

perl tools/lazysite-server.pl

Opens at http://localhost:8080/ serving the starter/ directory.

Options

• --port PORT - port to listen on (default: 8080)
• --docroot PATH - document root (default: ../starter relative to the script)
• --processor PATH - processor script path (default: ../lazysite-processor.pl relative to the script)
• --cache - respect cache files (default: always regenerate)
• --help - show help

Example

Serve your own site:

perl tools/lazysite-server.pl --docroot /path/to/public_html

Serve on a different port with caching enabled:

perl tools/lazysite-server.pl --port 3000 --cache

Default behaviour

• Cache is disabled by default (LAZYSITE_NOCACHE=1) so every request regenerates the page - edit and refresh to see changes
• Static files (CSS, JS, images, fonts) are served directly without invoking the processor
• Files with .md, .url, .tt, and .conf extensions are never served as static files
• Cached .html files are skipped when a matching .md or .url source exists - the processor always handles these
• URL query strings are passed to the processor via QUERY_STRING
• All CGI response headers from the processor are forwarded to the browser (Status, Content-type, Cache-Control, etc.)
• Request timing is shown in the terminal when Time::HiRes is available

Notes

• The server checks for required Perl modules on startup and warns about missing optional modules (e.g. JSON.Escape for search)
• Stderr from the processor is printed to the terminal for debugging
• The server listens on 0.0.0.0 (all interfaces)
• LAZYSITE_NOCACHE - cache bypass details