The most recent 9 LTS Version of TYPO3 is even easier to use and more accessible than ever before! Using only 5 simple steps, this tutorial explains how to successfully install TYPO3 9 LTS using a Windows Server.
This tutorial is also available for the TYPO3 8.7, TYPO3 8.0 as well as TYPO3 7LTS versions.
Eine Deutsche Version dieses Tutorials gibt es hier!
In order to smoothly install TYPO3 9 LTS, the following programs are necessary:
- A Webserver with a Database and PHP. The XAMPP Packet is most suitable for this. Using the following link XAMPP is available as a free download: apachefriends.org
- In order to edit images and graphics you are going to need GraphicsMagick: ftp://ftp.graphicsmagick.org/pub/GraphicsMagick/windows/
- You will also need an Editor to create and edit documents. Windows Editor, PSPad or Notepad ++ are all suitable.
- But most importantly: The most recent version of TYPO3, available for download as a Zip-File on TYPO3.org
Step 1: Installing XAMPP 7.2.11:
With just one click the file will simply install on it’s own. As of now the only option available is a 32Bit-Version, which works perfectly fine with a 64Bit-System as well.
Your antivirus software might go off, but most versions can just ignore this warning. Others however might need to deactivate the antivirus software during the installation process. Additionally, warnings due to the Restriction of the UAC might pop up.
All preset data can be adopted during the installation of XAMPP.
Now, you might need to deactivate the UAC for XAMPP. A detailed version on how to do this can be found using the following links:
For Windows 7: https://www.petri.com/disable-uac-in-windows-7
And for Windows 10: https://winaero.com/blog/how-to-turn-off-and-disable-uac-in-windows-10/
After that, Apache and MySQL need to be started using the XAMPP Control Panel. It is of importance that you are logged into an administrative account when opening XAMPP as the applications cannot be started otherwise.
As soon as Apache and MySQL are highlighted green, you can open the „localhost“ URL with your browser. The local Apache Friends site will open.
Step 2: Installing GraphicsMagick
The Installation of this program is pretty easy. You only need to choose between a 32- or 64Bit Version for your system software. Which version you need can be figured out by simultaneously pressing the Windows- and Pause-key. GraphicsMagick is usually installed in “C:\Program Files\GraphicsMagick-1.3.30-Q8”, where it can remain without problems.
Step 3: Installation and Configuration of TYPO3 9 LTS
First, you need to create a File with any name ( in this case „site“) in the index “C:\xampp\htdocs“.You must copy all files and folders of TYPO3 9 LTS into this exact file, after you have unpacked “typo3_src-9.5.0.zip”
Then, you need to open “localhost/site/” and “Index of/site” will also open automatically. The folder “typo3_src-9.5.0/“ is included. By clicking on it the following site will appear:
Step 4: Creating the FIRST_INSTALL file
By siting this file TYPO3 creates access authorization for the directory. The empty file with the above mentioned name needs to be created in a Windows Editior and saved to the index “C:\xampp\htdocs\site”. The ending .txt that is generated by the Editor needs to be removed.
What you need to keep in mind: Only the content of the folder needs to be copied into the file, not the complete folder, as this will not work.
Following this, “http://localhost/site/” is reloaded using Refresh and the installation routine starts automatically by clicking the folder “typo3_src-9.5.0”
A number of trouble codes will appear as TYPO3 has certain expectations towards the server that are nonexistent in the default configuration.
Two of these codes need to be eliminated by insertions in the file „php.ini“ using any Editor. The file can be found following the path “C:\xampp\php” and is used for the general configuration of php.
- max_execution_time = 30 increased to 240
- ; max_input_vars = 1000 is activated by removing the semicolon and increased to 1500 characters
Once you have changed the settings, Apache and MySQL in the XAMPP-Control Panel as well as the Website need to be restarted. Following this, the number of warning codes should have been reduced to just two error codes.
Finally, you need to increase the “ThreadStackSize” to 8MB. In order to do so you need to choose the path “C:\sampp\apache\conf\” and, using any Editor, enter the following lines into the file “httpd.conf”:
Pay attention: After yet another restart of Apache this error code will remain since TYPO3 9 LTS cannot survey this change. What you can do however, is check wether you have enough space at your disposition once the installation is successful. More on that later!
The last remaining error, “PHP openSSL extension not working” can simply be ignored as this is only concerning a local word processing system and it’s security is not as important in this case. On this too, more later!
Then, the MySQL data base is incorporated. In order to do so you need to fill in „root“ into the Username field. You do not need a password for the XAMPP-Installer.
The next step is to choose between a pre-existing data base and creating a new one. In this case we have sited a new base. You may also use a different database management system than MySQL.
Once this is done, an Admin-User is sited for the YPO3 Backend. The chosen password will also serve as a password for the Install-Tool.
The Installation is hereby completed!
If you want, you can download pre-set Websites by selecting “Yes, download the list of distributions.“ The Introduction-Package contains an extensive sample page.
Stepv 5: RSA Encryption and embedding GraphicsMagick
By clicking on “Take me straight to the Backend” we’ll continue. Sadly, the Login doesn’t work just yet, since TYPO3 uses RSA encryption by default.
This is important: Please do not close the the browser window containing the login mask!
Once again something needs to be changed within the configuration, but this time within TYPO3 itself. Using any editor the file “C:\xampp\htdocs\site\typo3conf\LocalConfiguration.php” is opened and in line 7 the entry ,loginSecurityLevel’ => ,rsa’ is changed and saved to ,loginSecurityLevel’ => ,normal’.
Now you can finally log in to the Backend. In case you have closed the browser window you can re-open it using “http://localhost/site/typo3”.
Important: As long as the extension further down hasn’t been deinstalled TYPO3 will overwrite the “loginSecurityLevel” time and time again (meaning “normal” continuously changes back to “RSA”)
If the Login still isn’t working you should once more change the entry in the LocalConfiguration.php but this time the browser window should definitely be open.
Now you can log in by username and previously chosen password.
Finally, you need to use the Install-Tool to check if the configuration is set accordingly in order to site GraphicsMagick for image processing. Using the pre-set password you can login.
“Configuration Presets” is chosen in the menu and “Image Handling” selected in order to track the path towards GraphicsMagick.
Now you only need to enter “c:/ProgramFiles/GraphicsMagick-1.3.26-Q16” into “Find executables in this directory” and activate it by clicking „Activate.“ Following this, the Radio-Button is marked in GraphicksMagick and once more activated by clicking „Activate.“ Using the menu item “Test Setup” you can check if exemplary graphics are generated accordingly.
The TYPO3 9 LTS Testversion is now fully operational! Have fun!
We’d love to hear your feedback!
The installation of TYPO3 has also been tested by us for the versions TYPO3 7LTS, TYPO3 8.0 as well as TYPO3 8.7 ! Should something malfunction or work differently for you we are happy to help fix the issue!
Did the installation work smoothly? If so, we’d love it if you shared this tutorial!
You can find even more information regarding TYPO3 CMS on the Pagemachine website.