Running Statamic locally is the preferred method for building and maintaining your sites. With version control (we recommend git), it's quite simple to deploy changes almost instantly from your local computer to a live site with a single command.
This video assumes you're serving your local sites using Laravel Valet.
To install Statamic locally you will need the following:
- A computer running MacOS, Windows, or Linux
- A supported version of PHP (we recommend PHP 8)
- Composer to manage PHP packages
Install Statamic CLI
Statamic CLI is a commandline tool to help you get Statamic installed quickly and easily. The package can be installed on your machine using Composer:
composer global require statamic/cli
Once installed, you can run the command
statamic list to see a list of available commands.
If you run into any issues or errors, check out this helpful article on what to do next.
In your terminal,
cd to the parent directory you want to start a new Statamic project in and run the install command.
statamic new $project_name
You'll be asked if you want to install a blank site or a Starter Kit. If this is your first time, we usually recommend starting with a blank site. Keep it simple.
Next, you'll be prompted to set up your first super admin user. Do it.
After that, everything is finished!
Accessing the site
The address where you access the site will be different depending on your development environment.
For example, if you're using Valet then your site would be at
http://$project_name.test and the Control Panel at
If you don't have Valet or some other server set up, you can run
php artisan serve to use the built-in server, then use the URL it provides, (which is typically
$ php artisan serveStarting Laravel development server: http://127.0.0.1:8000
If your local environment is reasonably "up to date", everything should have gone smoothly. But let's face it, tech doesn't always work the way it's supposed to on the first try.
Check out the troubleshooting section to get help about common error messages.
You're now (probably) running the latest and greatest version of Statamic! Well done! 🎉 You can now get on with the fun parts.
The Quick Start Guide is a great place to head next if you're just kicking the tires (or tyres — if you're not from our neck of the woods).
You can use Pro features while in development (like users, permissions revisions, REST API, and so on), by setting
'pro' => true in
The default install and all first-party Starter Kits use TailwindCSS in Just In Time mode, so anytime you change classes in your HTML you'll need to recompile your CSS.
This is super easy and happens automatically when you run
npm run dev from the terminal in your project directory (as long as you've run
npm install first).