1.1 - Login to console
Login to your Webserver's console via SSH or Directly
1.2 - Navigate to userdata folder
Navigate to to your the accounts's userdata folder and list it's contents using the following commands:
cd /var/cpanel/userdata/<account_name>
ls
1.3 - Edit config file
Edit the configuration file for the account's primary domain using the following command:nano <domain_name>
1.4 - Change document root directive
Change: documentroot: /home/public_html
To: documentroot: /home/public_html/web
1.5 - Save file
Save the file by:
- Press Ctrl+X to exit
- Enter 'Y' to save changes
- Leave the filename the same
- Press Enter to continue
1.6 - Edit SSL config file
Edit the configuration file for the account's primary domain, SSL version, using the following command:nano <domain_name>_SSL
1.7 - Change document root directive
Change: documentroot: /home/public_html
To: documentroot: /home/public_html/web
1.8 - Save file
Save the file by:
- Press Ctrl+X to exit
- Enter 'Y' to save changes
- Leave the filename the same
1.9 - Rebuild configuration and restart webserver
Rebuild the configuration and restart the webserver with the following commands:
/scripts/rebuildhttpdconf
service httpd restart
2.1 - Download Contao Manager
Download contao-manager.phar from the Contao Website.
2.2 - Upload and rename Contao Manager
Upload 'contao-manager.phar
' to '<account_root>/public_html/web
' and rename to 'contao-manager.phar.php
'
2.3 - Navigate to Contao Manager
In the browser of your choice visit '<primary_domain>/contao-manager.phar.php
'
2.4 - System check
You should arrive at the System Check, and most likely your Hosting Provider will not be automatically configured.
Click 'Configure' to setup your server.
2.5 - Server configuration
Configure your server by entering the path to your PHP executable, and click 'Save'. It will be automatically filled in if found by Contao Manager.
2.6 - Start installation
If your hosting provider is configured properly for Contao 4+ the System Check should complete successfully, and you can click 'Start Installation'.
2.7 - Choose Contao version
Choose your desired version of Contao and click 'Install Contao'. The newest version has the newest features, but the LTS (Long Term Support) variant promises to be updated for a set period of time so you can be sure that security updates will be available for the foreseeable future.
2.8 - Installation complete
If everything is successful you should be greeted with an Installation Complete message. Click 'Install Tool' to go to the Contao install tool to link your new installation to your SQL database and create your first admin user.
2.9 - Errors
If you have any other files or folder in your Contao install directory you will get an error. In your account's 'public_html
' you should only have 'web
' and 'contao-manager
' folders. Remove these files and/or folders and refresh the Contao Manager page in your browser. Hidden files start with a '.
' and may note be shown in cPanel file manager by default. To see hidden files in cPanel File Manager you need to enable them in the File Manager settings.
3.1 - Install Tool
If your not already at the Install Tool navigate to '<primary_domain>/contao/install
'
3.2 - Accept License
Read and accept the Contao License Agreement.
3.3 - Set Install Tool password
Enter a secure password for the Install Tool. You shouldn't need this password too frequently. Click 'Save password' to continue to the next step.
3.4 - Enter Database Credentials
You should have already created an SQL database and user for this Contao installation. Enter your Database credentials here, and click 'Save settings' to link your database to this installation.
3.5 - Update Database
Click 'Update database' to setup the tables in your SQL database.
3.6 - Create Admin User
We won't be importing any Templates, so just skip to the 'Create an admin user' section. Enter the user details and click the 'Create admin user' button to create the user and continue.
3.7 - Complete
Your Contao installation should now be complete. Click the 'Contao back end' link at the bottom right to continue to login for the first time.
3.8 - Login to the Contao Back End
Enter the username and password you setup on Step 6 to login to the Contao back end for the first time.