The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


statocles - Run Statocles commands


version 0.098


    statocles [-v] [--config <file>] [--include <dir>] [--lib] [--site <site>] <command>
    statocles -h|--help
    statocles -v|--version


The Statocles command-line interface. This command manages Statocles sites: building, testing, and deploying.

This command also helps to manage content in Statocles apps.



The command to run. Available commands:

    create <url>                    - Create a new site
    build [--date YYYY-MM-DD]       - Build the site
    daemon [-p <port>] [--date]     - Run an HTTP daemon to test the site
    deploy [--clean] [--date]       - Deploy the site
    bundle theme <name> [<file>...] - Bundle a theme
    apps                            - List the applications in this site
    <app> help                      - Get help for a specific application


config <file>

The configuration file to read for Sites. Defaults to site.yml.

The configuration file is a Beam::Wire container file.

site <name>

The site to use, which is the name of an object in the config file. Defaults to site.

include <dir>

The directory to search for includes. It works by prepending the path to @INC. If specified multiple times, it prepends the directories in the same order as written on the command line.


Shortcut for --include lib.

-p <port>

When running the daemon, choose which port to listen on. Defaults to 3000.

--date <date>

When running build, deploy, and daemon, set the current date for applications. This forces, for example, the blog app to show entries in the future.

Date should be in YYYY-MM-DD format.


When running deploy, delete the current site content before deploying. By default, old build files may be kept around after their source file is deleted. The --clean option removes all the files, so the site only contains what was built.

-v | --verbose

Display diagnostic information:

-h | --help

Display this help file


Display version information


Doug Bell <>


This software is copyright (c) 2016 by Doug Bell.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.