Kirby's command line interface helps you with regular tasks like the installation of the Kirby starterkit and updating your Kirby installation. It also offers a comfortable way to install templates, snippets, controllers and blueprints.

The Kirby CLI is being installed with Composer, the PHP package manager. For installation instructions for Composer, please visit the Composer website.

After installing composer, you can install Kirby CLI by running the following command:

composer global require getkirby/cli

Make sure to place the…

~/.composer/vendor/bin

…directory in your PATH so the kirby executable can be located by your system.

It can happen that you get into dependency issues with other global composer packages. In this case, try to install the CLI to a custom location without the global option and set the path accordingly.

composer require getkirby/cli

To update the CLI, run the following composer command:

composer global update getkirby/cli

Creates a new Kirby installation.

kirby install

By default the starterkit will be installed in a new directory called kirby. You can specify the directory with the second argument

kirby install mywebsite

You can also install any other official Kirby kit (starterkit, plainkit, langkit) with the --kit option

kirby install --kit langkit
kirby install --kit plainkit
kirby install --kit starterkit

If you've already setup your site structure and you want to add the Kirby core, you can run kirby install:core instead of kirby install

kirby install:core

If you want to add the panel to an existing installation, you can run…

kirby install:panel

Sometimes it might make sense to reinstall the index.php or use this in combination with kirby install:core and kirby install:panel to create your own folder structure:

kirby install:index.php

If you add the .htaccess manually or reinstall it, you can run…

kirby install:htaccess

To update an existing Kirby installation, you can run…

kirby update

This will update the kirby and panel folder, if it exists. You must run this within an existing Kirby installation, which follows Kirby's default folder structure.

You can install Kirby plugins with a valid package.json file and plugin type field from any repo on Github.

kirby plugin:install getkirby-plugins/cachebuster-plugin

You must pass the correct Github repository path as the second argument. The package.json file has to contain a type field with one of the following values:

• kirby-plugin (will be installed in /site/plugins)
• kirby-field (will be installed in /site/fields)
• kirby-tag (will be installed in /site/tags)

If you want to install a plugin from Kirby's official Plugins organisation (https://github.com/getkirby-plugins) you can omit the full path and just specify the repo name:

kirby plugin:install cachebuster-plugin

To update an existing plugin, you can use…

kirby plugin:update getkirby-plugins/cachebuster-plugin

The shortcut for official plugins is working here as well:

kirby plugin:update cachebuster-plugin

To create a boilerplate blueprint for a particular template, you can use the kirby make:blueprint command:

kirby make:blueprint projects

This will start the blueprint builder and take you through a couple questions to setup the blueprint options.

If you prefer to just create a clean boilerplate, you can use…

kirby make:blueprint projects --bare

This will create a fresh blueprint: /site/blueprints/projects.yml

To create a boilerplate controller for a particular template, you can use the kirby make:controller command:

kirby make:controller projects

This will create a fresh controller: /site/controllers/projects.php

To create a snippet, you can use the kirby make:snippet command:

kirby make:snippet header

This will create a fresh snippet: /site/snippets/header.php

To create a template, you can use the kirby make:template command:

kirby make:template projects

This will create a fresh template: /site/templates/template.php

To create a new user account, you can use the kirby make:user command:

kirby make:user -u home -p simpson -e homer@simpsons.com

The email is optional. You can also use the full option names:

kirby make:user --username home --password simpson --email homer@simpsons.com

This will create a new user in /site/accounts/homer.php

To create a new kirbytext tag template, you can use the kirby make:tag command:

kirby make:tag mytag

This will create a new tag boilerplate in /site/tags/mytag.php

To create a new plugin boilerplate, you can use the kirby make:plugin command:

kirby make:plugin myplugin

This will create a new plugin boilerplate in /site/plugins/myplugin/myplugin.php

Clears the cache directory

kirby clear:cache

Delets all thumbnails in /thumbs

kirby clear:thumbs

Prints the current version of the core, the panel and the toolkit

kirby version

http://www.opensource.org/licenses/mit-license.php

Bastian Allgeier
bastian@getkirby.com
https://getkirby.com
http://twitter.com/getkirby