Sophisticated, Lightweight and Simple

Jump to docs navigation
Edit on GitHub

Installation » Using the command-line

If you have command-line access, you can easily install Bolt by executing a few commands. First, create the directory where you want to install Bolt, if it doesn't already exist. We recommend installing Bolt outside the web root, you can read more on this here.

Enter the directory where you want to place the files, and execute the following commands:

curl -O
tar -xzf bolt-latest.tar.gz --strip-components=1
php app/nut init

If all goes well, you'll be greeted by the following:

Welcome to Bolt! - version 3.2.0.

If this set of commands didn't work because your server doesn't have curl, use wget instead.

That's all!

Next Steps

Web server configuration

After extracting the Tar or Zip file, you'll end up with a structure, similar to this:

├── app/
├── extensions/
├── public/
├── vendor/
├── composer.json.dist
└── composer.lock.dist

These are the folders that contain all of the Bolt code, resources and other files. Most of them are placed outside of the so-called web root. Only the 'public' folder needs to be accessible in the browser. After the first installation this folder is named public/ but as you read on, you will see that you can rename it to www/ or whatever your web server requires.

To do this, configure your webserver to use the public/ folder as the web root. For more information about this, see the pages on configuring Apache or Nginx.

If you bump into trouble setting this up, or you have no access to unchangeable in your web server's configuration, read the page Troubleshooting 'outside of the webroot'.


Bolt needs to be able to write data to a number of folders. For example the cache/ folder, and the files/ folder where uploaded images and other files will be saved.

Generally, servers should be fine with the default permissions. If your server needs to have the permissions set manually, you'll immediately notice when opening your new install in a browser window, because you will greeted by an error, and the message that you should fix this. If this happens, and you require guidance on setting up permissions, see our File System Permissions page.

Finishing Set-up

After extracting the files, checking the folder structure and setting up the vhost on your webserver, your Bolt installation should be good to go. Skip to the section Setting up Bolt.

Couldn't find what you were looking for? We are happy to help you in the forum, on Slack or on IRC.
Spotted a typo, or have something to add? Edit this page on GitHub.