Install Craft CMS locally

Learn how to install Craft CMS locally, matching your skills and workflows.

Get ready

Be ready, make sure to have a local development environment up and running and be aware of the different Craft deployment workflows available. Use the detailed official Craft 3 install guide as your guideline to install Craft on your local machine first.

Choose your Craft install workflow

The way you will install Craft will set the course on how you will deploy Craft CMS here on fortrabbit. Choose your workflow now:

1a. Download Craft with Composer

This is the recommended - more sophisticated - way. You will use Git and Composer in the Terminal. Run this command on you local machine to create a Craft 3 project to get started:

$ composer create-project craftcms/craft {{app-name}}

See an error? Check your local development. Later on you can deploy Craft with Git either to Universal or Professional Apps on fortrabbit.

1b. Download the Craft zip file

Are you more "designer" and less "developer"? SFTP also works here. Just download Craft directly from the Craft website: craftcms.com/latest-v3.zip. Unpack that zip file to get to the actual project files. Later on you can upload Craft with SFTP on Universal Apps.

Install Craft CMS locally

Craft 3 uses environment variables to access environment specific settings. With your fortrabbit Craft App, those variables are already set. Configure it to work on your local machine now. You have two options to install Craft:

2a. Terminal setup

# 1. go into your local Craft folder 
$ cd {{app-name}}

# 2. run the terminal installer
$ ./craft setup

This will ask you some questions, the defaults will work mostly, you can change these settings later.

2b. Browser setup

You can also run the installer in the browser by visiting this address: http://{{host}}/index.php?p=admin in your browser. Substitute {{host}} with the host name of your local development environment.

Next steps

By now your Craft CMS should be running on your local development machine. You should be able to visit your Craft installation locally and login to the Craft admin panel. Now it's time to configure Craft to work in both environments.

Further readings

Craft CMS

Install guides

Develop & deploy

Teamwork

Platform

Stacks

Need individual help?
Learn about Company plans ›
Looking for an old article?
See the full list of articles ›
Found an error?
Contribute on GitHub ›