This article is machine translated.
After you have checked all requirements and set up your web server, you can now start the installation.
There are two ways to install Contao on your server, using the graphical user interface of the ContaoManager or using the command line.
After the successful basic configuration, you can now install Contao. Select the desired version and the initial configuration and click the “Finish” button.
The installation can now take several minutes. Details about the installation process can be displayed by clicking the following icon.
When installing from the command line,
composer updatecommand is executed during the installation. This will cause some hosters not to be able to terminate the process due to high system load, and the installation will fail. In this case you should use theContao Manager.
You have logged on to your server with your user name and domain.
Change to the public directory of your web hosting.
Composer is an application-oriented package manager for the PHP programming language and installs dependencies.
If you install Composer locally, you will have a
composer.phar file in your working directory (i.e. where your project’s
composer.lock files are located). You would then call Composer with
If you install Composer globally, you can use the
composer command in any directory.
In the second step, you install Contao using the Composer. “example” stands for the desired installation directory and 4.8 for the version of Contao you want to install.
php composer.phar create-project contao/managed-edition example 4.8
In Contao, all publicly accessible files are located in the subfolder
/webof the installation. Use the admin panel of the hosting provider to set the document root of the installation to this subfolder and create a database on this occasion.
example.compoints to the directory
Pro Contao installation therefore requires its own (sub)domain.
After installation, you can update the database using the Contao install tool.
Since Contao 4.9 you can use the following command on the command line:
php vendor/bin/contao-console contao:migrate
You can also create a database beforehand on the command line:
php vendor/bin/contao-console doctrine:database:create
Contao needs to know the corresponding connection data for your database. This information can either be retrieved via
an existing “config/paramters.yml” (currently installed using the Contao-Install tool)
or via a “.env” file
in the root directory of your installation.
For details on the necessary environment variables (DATABASE_URL and APP_SECRET) in a “.env” file you can find here.
Using the Contao-Installtool, you can create your back end user. Since Contao 4.10 you can use the following command on the command line:
php vendor/bin/contao-console contao:user:create