Statamic utilizes Composer to manage its dependencies. So, before using Statamic, make sure you have Composer installed on your machine.

We have a screencast about this! Watch Now

Creating a new Statamic project?

If you’re starting a new site from scratch, we recommend using one of the following methods.

Via Statamic CLI Installer (preferred method)

First, download the Statamic CLI installer using Composer:

composer global require statamic/cli

Make 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.

If you run into any errors, check out this helpful article on what to do next.

Once installed, run the following command to kickstart a fresh new Statamic project (and even choose from some free Starter Kits).

statamic new {site_name}

Via Composer

You can install Statamic with regular, old Composer if you’d prefer. To do so, you’ll probably want to use the statamic/statamic empty starter site.

composer create-project --prefer-dist statamic/statamic {site_name}

After you’ve installed, make sure to point your web server to your public folder. If you use Laravel Valet, that will be automatically picked up.

Starter Kits

Looking to jump right into a ready-made site?

Official Starter Kits

Community Starter Kits

You can also install into an existing Laravel app

  1. Add the statamic:install command to post-autoload-dump in composer.json.

    "post-autoload-dump": [
        "@php artisan package:discover --ansi",
        "@php artisan statamic:install --ansi"
  2. Require statamic/cms.

    composer require statamic/cms --with-dependencies
  3. Head over to the Storing User Records section and follow the instructions for the scenario that makes sense for your project. If you want to continue to keep users in a database, you can jump straight over to Storing Users in a Database in an existing Laravel app.

After Statamic is installed, you’ll have the content/, users/, and config/statamic directories added to your project. Your app will continue to work as before and you’ll have Statamic available at your fingertips.

Your explicit routes will take precedence and anything not caught by your app will run through Statamic and will work as documented. Enjoy!

Make sure your Laravel config is not cached before installing Statamic. If you’re not sure run php artisan config:clear.

Next Steps

Once you’ve installed Statamic, you’re ready to start building! Check out the Quick Start page for a walkthrough on how to build a simple site, access the Control Panel, creating a user, and more.

If you want to use Pro features while in development (like users, permissions & groups, revisions, and git integration), set 'pro' => true in config/statamic/editions.php.

Want to jump right in? You can create a user by running php please make:user, and heading to


Statamic is updated using Composer either directly on the command line or through the Control Panel.

Command Line

From within your project, use Composer to update the Statamic CMS package:

composer update statamic/cms --with-dependencies

You may prefer to run composer update to update all of your dependencies listed in your composer.json file

Control Panel

You may also update Statamic from within the Control Panel. Head to the “Updates” section and click update.

Updating via the CP will lock that specific version of statamic/cms in your composer.json. If you want to update using the command line later, you’ll need to update the version manually before running composer update.

Betterify this page on Github!