Installation » The traditional way, using (S)FTP
Download the latest version of Bolt.
.zip file, and upload to your webhost using the (S)FTP client of
Note: Don't forget to upload the
.htaccess file, if you're using Apache! Bolt won't work without it.
If you can't find the file on your file system, download this
file. Upload it to your server, and then rename it to
If you're on OSX and you don't see the file, it might be that your system is
set up to 'hide' hidden files, that start with a
You can usually still find it, when browsing local files using your FTP client.
Note: We recommend installing Bolt outside the web root, following commonly accepted best practices setup for web applications. You can read more on this here. If this is not possible on your server environment, you can use the so-called "Flat distribution", as an alternative.
Web server configuration¶
After extracting the Tar or Zip file, you'll end up with a structure, similar to this:
. ├── app/ ├── extensions/ ├── public/ ├── vendor/ ├── README.md ├── composer.json └── composer.lock
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/ needs to be accessible in the browser.
If you bump into trouble setting this up, or you have no access to change your web server's configuration, read the page Troubleshooting 'outside of the webroot'. If this is not possible on your server environment, you can use the so-called "Flat distribution", as an alternative.
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.
After you've done this, skip to the section Setting up Bolt.