🌴 Install and manage your Statamic projects from the command line.
composer global require statamic/cliMake sure to place Composer's system-wide vendor bin directory in your $PATH so the statamic executable can be located by your system. Here's how.
Once installed, you should be able to run statamic {command name} from within any directory.
When you install starter kits, the CLI might present you with a warning that the GitHub API limit is reached. Generate a Personal access token and paste it in your terminal with this command so Composer will save it for future use:
composer config --global --auth github-oauth.github.com [your_token_here]Read more on this in the Composer Docs.
composer global update statamic/cliRun this command to update the CLI tool to the most recent published version. If there's been a major version release, you may need to run require instead of update.
You may create a new Statamic site with the new command:
statamic new my-siteThis will present you with a list of supported starter kits to select from. Upon selection, the latest version will be downloaded and installed into the my-site directory.
You may also pass an explicit starter kit repo if you wish to skip the selection prompt:
statamic new my-site statamic/starter-kit-cool-writingsFrom within an existing Statamic project root directory, you may run the following command to quickly find out which version is being used.
statamic versionFrom within an existing Statamic project root directory, you may use the following command to update to the latest version.
statamic updateThis is just syntactic sugar for the composer update statamic/cms --with-dependencies command.