How to install Backdrop CMS
If you're looking to install Backdrop from the command line, see our advanced instructions.
After the installation is complete, you will be redirected to your site's home page.
Step1: Download Backdrop and extract the files
Once downloaded, most computers can extract the files with a double-click. On nix systems you may need to use the unzip command.
Make sure that the files are placed in a functional webroot, you will need to access the website with a browser for step 3.
Step 2: Enter the MySQL database information in settings.php
Backdrop needs both a database, and a database user in order to be installed, and these need to be specified in the
settings.phpfile. In most cases, Backdrop will update this file for you automatically as you go through the installer steps. So you may want to try skipping to the next step, and give it a go. If the installer is not able to automatically configure your
settings.phpfile, you will need to return to this step, and update it manually:
settings.phpfile in a text editor, and locate the "Database configuration" section at the top. Enter the database username and password, and provide the database name (replace the
'mysql://user:pass@localhost/database_name'accordingly, with the respective actual values - the result will be something like
If the database user you provided has enough privileges to create the database (this is common on shared hosting) Backdrop will create the database for you; if not, then you will need to create the database manually:
(optional) Create the MySQL database
If Backdrop is unable to create the database for you, you will need to create an empty database manually.
The database can be created using a browser-based control panel like PHPMyAdmin or cPanel, or from the mysql command line.
Create a database, and make a note of the database name and hostname (usually localhost).
(optional) Create the database user
If you do not already have a database user, you will need to create one manually.
The database user can also be created using a browser-based control panel like PHPMyAdmin or cPanel, or from the mysql command line.
Create a database user, and make a note of the username and password. Grant this new user ALL privileges on the database just created.
GRANT ALL ON databasename.* TO 'username'@'localhost' IDENTIFIED BY 'password';
Step 3: Run the installer
The installer will guide you through several questions:
- Choose language
If you want to install using a language other than English, see Learn how to install Backdrop in other languages.
- (hidden) Choose installation profile
In most cases, this question will not be shown to you, since the standard installation profile is optimal. It is shown only when installing a special distribution of Backdrop.
- Verify requirements
If your installation directory is not configured properly, you'll be informed on this page. Correct each problem, and either refresh the browser window or click 'Proceed with the installation' to see if there are any other errors.
- Set up database
This question will be skipped if you have manually updated you
settings.phpfile with the correct database information in Step 2. If shown, enter the database name, the username, and password as per Step 2. Note that this is not the username and password for your Backdrop site; those will be created in the next step.
- Installing Backdrop
A progress bar will appear and display updates regarding the progress of the installation. If no errors are encountered, the next page will automatically load in your browser.
- Set site info & main account
Provide basic settings like your site name and logo. Also supply information for the first user account (this account will be assigned full administration permissions)
- Choose language
Troubleshooting / Additional steps
Set the permissions/ownership of the settings.php file
After the installation is complete, you may want to confirm that the permissions on the settings.php file is write-protected. Important: Failing to remove write permissions to the settings.php file is a security risk.
Set the permissions/ownership on the files directory
filesdirectory in the Backdrop root must be writable by the webserver.
If the user who logs into the server (either by ftp or ssh) is
myuserand the webserver user is
www-datathen sensible ownership and permissions for the files directory could be:
drwxrwx--- 13 myuser www-data 442B Nov 5 18:38 files
You can achieve this configuration either in your FTP client or on the command line with commands like this:
chown -R myuser:www-data files && chmod -R 770 files
Note: you may need
sudodepending on the access of the user who owns the directory.